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Preface 


Intended Audience 

This manual is intended for general users, system managers, and programmers 
who use the OpenVMS VAX Version 6.1 operating system. 

This document contains descriptions of the new features for OpenVMS VAX 
Version 6.1. For information about how some of the new features might impact 
your system, read the OpenVMS VAX Version 6.1 Release Notes before you install, 
upgrade, or use Version 6.1. 

Document Structure 

This manual is organized as follows: 

• Chapter 1 contains a summary of the new OpenVMS VAX Version 6.1 
software features. 

• Chapter 2 describes new features of interest to general users of the OpenVMS 
VAX Version 6.1 operating system. 

• Chapter 3 describes new features that are applicable to the tasks performed 
by system managers. 

• Chapter 4 describes new features that support programming tasks. 

• Chapter 5 describes several new features of the DECwindows Motif display 
server. 

• Chapter 6 describes OpenVMS system programming support for the SCSI-2 
standard. 

• Appendix A describes new or changed messages from the Help Message 
database. 

Associated Documents 

Refer to the following documents for detailed information about the OpenVMS 
VAX Version 6.1 software features described in this manual. For more 
information about how to order these documents, see the Overview of OpenVMS 
Documentation or contact your Digital representative. 

• DEC net for OpenVMS Networking Manual 

• DECnet/OSI for OpenVMS Introduction , Planning, and Glossary 

• Managing DECwindows Motif for OpenVMS Systems 

• OpenVMS DCL Dictionary 

• OpenVMS Debugger Manual 

• OpenVMS I/O User's Reference Manual 


IX 




• OpenVMS Record Management Services Reference Manual 

• OpenVMS Record Management Utilities Reference Manual 

• OpenVMS RTL Library (LIB$) Manual 

• OpenVMS RTL Screen Management (SMG$) Manual 

• OpenVMS System Management Utilities Reference Manual 

• OpenVMS System Manager's Manual 

• OpenVMS System Messages: Companion Guide for Help Message Users 

• OpenVMS System Services Reference Manual 

• OpenVMS Utility Routines Manual 

• OpenVMS VAX Device Support Manual 

• OpenVMS VAX Device Support Reference Manual 

• OpenVMS VAX Version 6.1 Release Notes 

• POLYCENTER Software Installation Utility User's Guide 

• POLYCENTER Software Installation Utility Developer's Guide 

• VMS DECwindows Guide to Xlib Programming: MIT C Binding 

• Volume Shadowing for OpenVMS 

• X and Motif Quick Reference Guide 


Conventions 

In this manual, every use of OpenVMS AXP means the OpenVMS AXP operating 
system, every use of OpenVMS VAX means the OpenVMS VAX operating system, 
and every use of OpenVMS means both the OpenVMS AXP operating system and 
the OpenVMS VAX operating system. 

The following conventions are used in this manual: 

CtrVx A sequence such as CtrVx indicates that you must hold down 

the key labeled Ctrl while you press another key or a pointing 
device button. 

PF1 x A sequence such as PF1 x indicates that you must first press 

and release the key labeled PF1, then press and release 
another key or a pointing device button. 

1 Return | In examples, a key name enclosed in a box indicates that 

you press a key on the keyboard. (In text, a key name is not 
enclosed in a box.) 

... A horizontal ellipsis in examples indicates one of the following 

possibilities: 

• Additional optional arguments in a statement have been 
omitted. 

• The preceding item or items can be repeated one or more 
times. 

• Additional parameters, values, or other information can be 
entered. 


x 






() 

[] 

{} 

boldface text 

italic text 

UPPERCASE TEXT 

numbers 

mouse 

MB1, MB2, MB3 


A vertical ellipsis indicates the omission of items from a code 
example or command format; the items are omitted because 
they are not important to the topic being discussed. 

In format descriptions, parentheses indicate that, if you 
choose more than one option, you must enclose the choices 
in parentheses. 

In format descriptions, brackets indicate optional elements. 

You can choose one, none, or all of the options. (Brackets are 
not optional, however, in the syntax of a directory name in 
an OpenVMS file specification or in the syntax of a substring 
specification in an assignment statement.) 

In format descriptions, braces surround a required choice of 
options; you must choose one of the options listed. 

Boldface text represents the introduction of a new term or the 
name of an argument, an attribute, or a reason. 

Boldface text is also used to show user input in Bookreader 
versions of the manual. 

Italic text emphasizes important information and indicates 
complete titles of manuals and variables. Variables include 
information that varies in system messages (Internal error 
number ), in command lines (/PRODUCER=narae), and in 
command parameters in text (where device-name contains up 
to five alphanumeric characters). 

Uppercase text indicates a command, the name of a routine, 
the name of a file, the name of a file protection code, or the 
abbreviation for a system privilege. 

A hyphen in code examples indicates that additional 
arguments to the request are provided on the line that follows. 

All numbers in text are assumed to be decimal, unless 
otherwise noted. Nondecimal radixes—binary, octal, or 
hexadecimal—are explicitly indicated. 

The term mouse refers to any pointing device, such as a mouse, 
a puck, or a stylus. 

MB1 indicates the left mouse button, MB2 indicates the middle 
mouse button, and MB3 indicates the right mouse button. (The 
buttons can be redefined by the user.) 
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Overview of OpenVMS VAX Version 6.1 New 

Features 


This chapter contains an overview of the new software features supported by 
OpenVMS VAX Version 6.1. 

1.1 Summary of New Software Features 

Table 1-1 provides a summary of new features supported by OpenVMS VAX 
Version 6.1. 


Table 1-1 Summary of OpenVMS VAX Version 6.1 Software Features 

General Features 


Convert/Reclaim utility 


DCL commands 


DECwindows Motif 


Support for file shelving 


Help Message utility additions 


A new command qualifier allows users more selectivity for 
reclamations and statistics. 

DCL commands are now modified to be common to OpenVMS VAX 
and OpenVMS AXP. 

There are changes to the DEBUG command to invoke the Kept 
Debugger. 

A new PRODUCT command invokes the POLYCENTER Software 
Installation utility (PCSI). 

There are changes to the commands: DIFFERENCES, 
DIRECTORY, REPLY, SET FILE, SET PROCESS, SHOW 
MEMORY, SHOW PROCESS, TYPE, and to the lexical function 
F$FILE_ATTRIBUTES. 

The following commands now support the output navigation 
qualifers: DIFERENCES, DIRECTORY, DUMP, HELP, SEARCH, 
SHOW AUDIT, SHOW DEVICES, SHOW ENTRY, SHOW ERROR, 
SHOW LICENSE, SHOW LOGICAL, SHOW MEMORY, SHOW 
PROCESS, SHOW QUEUE, SHOW SYSTEM, SHOW USERS, 
TYPE. 

The new command SET SERVER controls starting, stopping, and 
restarting of the security server. 

DECwindows Motif Version 1.2 for OpenVMS provides 
DECnet/OSI full names support. 

OpenVMS now supports the POLYCENTER HSM for OpenVMS 
layered product. 

There are new /WORK.FILES and /SECTION_FILE qualifiers. 
Search paths can now specify directories. 


(continued on next page) 
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Overview of OpenVMS VAX Version 6.1 New Features 
1.1 Summary of New Software Features 


Table 1-1 (Cont.) Summary of OpenVMS VAX Version 6.1 Software Features 


System Management Features 

DECdtm Transaction Log 
Management 

There is a new LMCP utility command, CLOSE LOG. 

Error Formatter 

The Error Formatter (ERRFMT) now notifies users when it 
encounters a fatal error. 

File system performance 
improvements for PATH WORKS 
users 

Improved concurrency allows multiple processes to create files on a 
single disk in parallel. 


Multiblock bitmap reads reduce the time spent by the file system 
in allocating files. 

SHOW LICENSE command 

There are two new qualifiers: /CLUSTER, /USAGE. 

Support for full names 

There is support for DECnet/OSI full names. 

Monitoring Performance History 
Program 

A new program to collect reliability data from systems being used 
in customer environments has been added. 

POLYCENTER Software Installation 
Utility 

A new technology simplifies the distribution and management of 
software. 

New system parameters 

Two new system parameters related to volume shadowing have 
been added: SHADOW_SYS_TMO, SHADOW_SYS_WAIT. 

Volume Shadowing for OpenVMS 

Volume shadowing is available for OpenVMS AXP systems and 
is supported in VMSclusters that contain both VAX and AXP 
computers. 


Volume shadowing licenses are now available on a per disk basis, 
along with the traditional capacity (per CPU) licenses. 

Programming Features 


Batch and print queuing system LAT symbiont customization has been added, 

features 


Convert/Reclaim utility DCL interface A new qualifier allows users more selectivity in doing bucket 

reclamations and obtaining statistics. 

CPU and I/O statistics are displayed by the CONVERT/RECLAIM 
/STATISTICS command. 


Callable Convert and Convert 
/Reclaim routines 

CONV$RECLAIM utility routine 

OpenVMS Debugger 


FDL$CREATE routine calls 
File information block (FIB) 


The callable Convert and Convert/Reclaim routines now provide 
users with symbolic offset access to options and statistics arrays. 

A new key selection parameter has been added. 

DECwindows Motif has user interface enhancements. 

Connect/disconnect support has been added. 

The Kept Debugger is now invoked with a DCL command. 

Support for DECnet/OSI full names has been added. 

The new Heap Analyzer feature provides a graphical 
representation of memory use in real time. 

Changes to online Help have been made. 

Calls to FDL$CREATE now support the optional argument 
dflt_fdl_spc . 

Subfields now support both OpenVMS VAX systems and OpenVMS 
AXP systems. 


(continued on next page) 
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Overview of OpenVMS VAX Version 6.1 New Features 
1.1 Summary of New Software Features 


Table 1-1 (Cont.) 


Summary of OpenVMS VAX Version 6.1 Software Features 


Local Area Network (LAJM) device 
drivers 

LOGINOUT callout routines 
RMS 


OpenVMS RTL Library (LIB$) 
System services 



Programming Features 

FIB$L_ACCTL now supports OpenVMS VAX systems and 
OpenVMS AXP systems. 

IO$_CREATE now supports OpenVMS VAX systems and 
OpenVMS AXP systems. 

IO$_MODIFY has field and subfield values that support OpenVMS 
VAX systems and OpenVMS AXP systems. 

The Movefile subfunction supports both OpenVMS VAX systems 
and OpenVMS AXP systems. 

New LAN drivers are available. 

LOGINOUT callout routines have been documented. 

A new search option allows the return of the previous key in an 
ISAM file. 

Enhancements to the XABITM data structure support file shelving. 
Support for DECnet/OSI full names has been added. 

New item codes for terminal devices have been added. 

Enhancements to the $FILESCAN system service support full 
names. 

The following new system services are included for the proxy 
database: 

• $ADD_PROXY 

• $DELETE_PROXY 

• $DISPLAY_PROXY 

• $VERIFY_PROXY 


The following new system services are included for the intrusion 
database: 

• $DELETE_INTRUSION 

• $SCAN_INTRUSION 

• $SHOW_INTRUSION 

The following system service is included for file shelving: 

• $SETSHLV 


DECwindows Motif Display Server Features 


Several new symbols have been created to customize the 
DECwindows Motif display server. 

New DECwindows keymap name support has been added. 

New font names for the display server have been added. 

(continued on next page) 



DECwindows server customization 
parameters 

New keymap name support 
New font support 
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Table 1-1 (Cont.) Summary of OpenVMS VAX Version 6.1 Software Features 


Programming Support for SCSI-2 Devices 


Tagged command queuing for SCSI-2 OpenVMS now supports the tagged command queuing architecture 
devices of the SCSI-2 standard and provides an extended OpenVMS SCSI 

port interface (SPI$) for SCSI-2 devices. 
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_2 

General Features 


This chapter highlights new features of general interest to OpenVMS VAX 
Version 6.1 users. For detailed information about a feature, refer to the identified 
manual in the OpenVMS documentation set. In addition, refer to the OpenVMS 
VAX Version 6.1 Release Notes for information about possible system impact. 

2.1 CONVERT/RECLAIM /KEY Qualifier 

The CONVERT/RECLAIM command now takes the /KEY qualifier allowing 
the user more selectivity in doing bucket reclamations and obtaining related 
statistics. See Section 4.2 for more information. 

2.2 New and Modified DCL Commands and Lexical Functions 

OpenVMS VAX Version 6.1 provides some new DCL commands and some changes 
to existing DCL commands and lexical functions. For more information about 
DCL commands and lexical functions, see the OpenVMS DCL Dictionary. 

2.2.1 Platform-Specific Attributes Have Been Removed 

In OpenVMS VAX Version 6.0 and OpenVMS AXP Version 1.5, a number of DCL 
commands and lexical functions had some attributes that were specific to either 
OpenVMS VAX or OpenVMS AXP systems. In OpenVMS VAX Version 6.1 and 
OpenVMS AXP Version 6.1, these attributes are no longer system-specific. The 
following commands or lexical functions are now equivalent on both systems: 

ALLOCATE 

ASSIGN/MERGE 

ASSIGN/QUEUE 

DELETE/ENTRY 

DELETE/QUEUE 

DELETE/QUEUE/MANAGER 

DISABLE/AUTOSTART 

ENABLE/AUTOSTART 

F$GETQUI 

F$IDENTIFIER 

F$SETPRV 

INITIALIZE/QUEUE 

PRINT 

SET AUDIT 

SET DIRECTORY 

SET FILE 

SET HOST 

SET PROCESS 

SET PROTECTION/DEFAULT 

SET QUEUE 

SET RIGHTS_LIST 
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General Features 

2.2 New and Modified DCL Commands and Lexical Functions 


SET SECURITY (replaces SET ACL, SET PROTECTION, 

SET PROTECTION, and SET UIC) 

SET VOLUME 
SHOW AUDIT 
SHOW CLUSTER 
SHOW INTRUSION 

SHOW MEMORY (the /CACHE qualifier) 

SHOW QUEUE/MANAGER 

SHOW SECURITY (replaces SHOW ACL) 

SPAWN 

START/QUEUE 

START/QUEUE/MANAGER 

STOP/QUEUE 

STOP/QUEUE/MANAGER/CLUSTER 

STOP/QUEUE/NEXT 

STOP/QUEUE/RESET 

STOP/QUEUES/ON_NODE 

SUBMIT 

UNLOCK 

2.2.2 DEBUG Command 

The information in this section about the DEBUG command is new. 

/KEEP 

Invokes the Kept Debugger. The Kept Debugger includes a run/rerun capability 
that allows you to debug an image multiple times or to debug a series of distinct 
images without exiting the debugger. 

Issuing the DEBUG/KEEP command is the only way to invoke the Kept 
Debugger. 

/RESUME (default) 

Reinvokes the non-Kept Debugger after a Ctrl/Y key sequence has interrupted 
the execution of a program you are debugging. (The interrupted program must 
not have been linked with a /NOTRACEBACK qualifier on the LINK command.) 

If you issue the DEBUG/RESUME command without a previous Ctrl/Y key 
sequence, no action occurs. Use the RUN program-name command to invoke the 
non-Kept Debugger. 

The following example was added to the documentation: 

Examples 

1. $ FORTRAN/DEBUG/NOOPTIMIZE WIDGET 

$ LINK/DEBUG WIDGET 
$ RUN/NODEBUG WIDGET 

NAME: 

NAME: 

NAME: 

fCtii/Y] 

$ DEBUG 


%DEBUG-I-INITIAL, language is FORTRAN, module set to WIDGET 
DBG> 
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General Features 

2.2 New and Modified DCL Commands and Lexical Functions 


The FORTRAN and LINK commands both specify the /DEBUG qualifier to 
compile the program WIDGET.FOR with debugger symbol table information 
and to include the debugger in the image file. The RUN command begins 
execution of the image WIDGET.EXE, which loops uncontrollably. The key 
sequence Ctrl/Y interrupts the program, and the DEBUG command gives 
control to the debugger. 

2.2.3 DIFFERENCES Command 

The following additions were made to the DIFFERENCES command: 

• The /IGNORE=CASE qualifier allows a case-insensitive search for record 
differences. 

• The command supports output navigation qualifiers (see Section 2.2.15). 

2.2.4 DIRECTORY Command 

The following additions were made to the DIRECTORY command. 

2.2.4.1 New Keywords for /SELECT Qualifier 

The /SELECT=(keyword[,...]) qualifier allows you to select files for display using 

the keywords in Table 2—1. By default, file selection is based on other criteria. 


Table 2-1 New Keywords for the /SELECT Qualifier 


ACL Displays files that have an associated ACL or files 

NOACL that do not (NOACL keyword). 

FILE=(option[,...]) Displays portions of the file specification. The 

/SELECT=FILE qualifier is used to turn off specific 
portions by explicit or implicit specification of the 
options. Possible options are: 

[NO] NODE 
[NO] DEVICE 
[NO] DIRECTORY 
[NO] NAME 
[NO] TYPE 
[NO] VERSION 


The /SELECT=FILE qualifier cannot be used with 
the /FULL qualifier. 

ONLINE Displays files that are on line or shelved. 

NOONLINE 

SHELVABLE Displays files that are shelvable or not shelvable. 

NOSHELVABLE 


2.2.4.2 /SHELVED_STATE Qualifier 

Specifying the /SHELVED_STATE qualifier displays whether a file is shelved or 
on line. For more information about file shelving, see Section 2.4. 

2.2.4.3 Output Navigation Qualifiers 

The DIRECTORY command supports the output navigation qualifiers (see 
Section 2.2.15). 
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General Features 

2.2 New and Modified DCL Commands and Lexical Functions 

2.2.5 F$FILE_ATTRIBUTES Lexical Function 

Table 2-2 lists the new items you can specify with the F$FILE_ATTRIBUTES 
lexical function, the return type, and the information returned. For a complete 
list of F$FILE_ATTRIBUTES items, see the OpenVMS DCL Dictionary. 


Table 2-2 F$FILE_ATTRIBUTES Items 


Item Code 

Return Type 

Returns This Information 

MOVE 

String 

TRUE if movefile operations are enabled; returns 
TRUE or FALSE 

SHELVED 

String 

TRUE if the file is shelved; returns TRUE or 
FALSE 

SHELVABLE 

String 

TRUE if the file is eligible to be shelved; returns 
TRUE or FALSE 


For more information on file shelving see Section 2.4. For more information on 
the movefiles subfunction, see the OpenVMS I/O Users Reference Manual. 

2.2.6 F$GETSYI Lexical Function 

The following item (Table 2—3) was added to the F$GETSYI lexical function. This 
item returns system information about either your local node or another node 
in your VMScluster system. For a complete list of F$GETSYI items, see the 
OpenVMS DCL Dictionary. 


Table 2-3 F$GETSYI Item for the Local Node or for Other Nodes in the 
VMScluster 


Item 

Return 

Type 

Information Returned 

DECNET 

FULLNAME 

String 

The node name of a DECnet Phase IV system or 
the node full name of a DECnet/OSI system. 


2.2.7 New PRODUCT Command 

The PRODUCT command is a new command that invokes the POLYCENTER 
Software Installation Utility (PCSI) to do one of the following: 

• Install one or more software products 

• Remove one or more software products 

• Perform other related operations 

For more information, see Section 3.7. For a complete description of the 
POLYCENTER Software Installation utility and the use of the PRODUCT 
command, see the POLYCENTER Software Installation Utility User's Guide. 

2.2.8 REPLY Command 

Messages pertaining to LICENSES have been added to the list of messages that 
can be displayed or inhibited from broadcasting to terminals. 
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2.2.9 SET FILE Command 

The SET FILE command has the following new qualifier: 

/SHELVABLE 

/NOSHELVABLE 

/SHELVABLE controls whether the file is shelvable. 

For more information on file shelving see Section 2.4. 

2.2.10 SET PROCESS Command 

The SET PROCESS command has a new /AUTO_UNSHELVE qualifier. The 
/PRIVILEGES qualifier has been modified to include four new privileges (AUDIT, 
DOWNGRADE, IMPORT, and UPGRADE). 

/AUTO_UNSHELVE 

/NOAUTO_UNSHELVE 

Controls whether the process automatically unshelves files. For more information 
on file shelving see Section 2.4. 

/PRIVILEGES=(privilege[,...]) 

The /PRIVILEGES qualifier requires SETPRV (set privilege) privilege as an 
authorized privilege to enable any privilege you do not have in your authorized 
privilege mask. 

Table 2-4 lists the process privileges available on OpenVMS systems. 


Table 2-4 OpenVMS System Process Privileges 


ACNT 

ALLSPOOL 

ALTPRI 

AUDIT 

BUGCHK 

BYPASS 

CMEXEC 

CMKRNL 

DETACH 

DIAGNOSE 

DOWNGRADE 

EXQUOTA 

GROUP 

GRPNAM 

GRPPRV 

IMPORT 

LOG_IO 

MOUNT 

NETMBX 

OPER 

PFNMAP 

PHY_IO 

PRMCEB 

PRMGBL 

PRMMBX 

PSWAPM 

READALL 

SECURITY 

SETPRV 

SHARE 

SHMEM 

SYSGBL 

SYSLCK 

SYSNAM 

SYSPRV 

TMPMBX 

UPGRADE 

VOLPRO 

WORLD 



2.2.11 New SET SERVER Command 

The SET SERVER command is a new command that enables you to start, stop, 
and restart the security server. The security server maintains information stored 
in the system intrusion and proxy databases. 

The system intrusion database is used by LOGINOUT, DECnet/OSI, 
DECwindows, SHOW INTRUSION, DELETE INTRUSION, and other 
applications. For more information about the system intrusion database and 
$DELETE_INTRUSION, $SCAN_INTRUSION, and $SHOW_INTRUSION 
system services, see the OpenVMS System Services Reference Manual. For 
further information, see the OpenVMS Guide to System Security. 
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The system proxy database is used by AUTHORIZE, DECnet/OSI, DFS, and 
other applications to access information stored in the network proxy database. 
Additional information can be found in the OpenVMS System Management 
Utilities Reference Manual. See also the $ADD_PROXY, $DELETE_PROXY, 
$DISPLAY_PROXY, $SHOW_PROXY, and $VERIFY_PROXY system services in 
the OpenVMS System Services Reference Manual. 

2.2.12 SHOW MEMORY Command 

The SHOW MEMORY command supports the output navigation qualifiers (see 
Section 2.2.15). 

Also, the /CACHE qualifier is now common to OpenVMS systems. 

2.2.13 SHOW PROCESS Command 

The SHOW PROCESS command has a new /SHELVING qualifier: 

/SHELVING 

/SHELVING displays whether the process automatically unshelves files. 

For more information on file shelving, see Section 2.4. 

The SHOW PROCESS command also supports the output navigation qualifiers 
(see Section 2.2.15). 

2.2.14 TYPE Command 

When you use the TYPE command and specify a file name but not a file type, the 
file type defaults to .LIS. However, you can specify a different default file type 
with the TYPE$DEFAULT_FILESPEC logical name. 

The TYPE command supports the output navigation qualifiers (see 
Section 2.2.15). 

2.2.15 Output Navigation Qualifiers 

The commands listed in Table 2—5 support the output navigation qualifiers. 


Table 2-5 Commands That Support the Output Navigational Qualifiers 


Command 

/EXACT 

/HEADER /HIGHLIGHT /PAGE 

/SEARCH 

/WRAP 

DIFFERENCES 

X 

X 

X 

X 

X 

DIRECTORY 

X 

X 

X 

X 

X 

DUMP 

X 

X 

X 

X 

X 

HELP 

X 

X 

X 

X 

X 

SEARCH 


X 

X 


X 

SHOW AUDIT 

X 

X 

X 

X 

X 

SHOW DEVICES 

X 

X 

X 

X 

X 

SHOW ENTRY 

X 

X 

X 

X 

X 

SHOW ERROR 

X 

X 

X 

X 

X 

SHOW LICENSE 

X 

X 

X 

X 

X 

SHOW LOGICAL 

X 

X 

X 

X 

X 





(continued on next page) 
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Table 2-5 (Cont.) Commands That Support the Output Navigational Qualifiers 


Command 

/EXACT 

/HEADER 

/HIGHLIGHT 

/PAGE 

/SEARCH 

/WRAP 

SHOW MEMORY 

X 


X 

X 

X 

X 

SHOW PROCESS 

X 


X 

X 

X 

X 

SHOW QUEUE 

X 


X 

X 

X 

X 

SHOW SYSTEM 

X 


X 

X 

X 

X 

SHOW USERS 

X 


X 

X 

X 

X 

TYPE 

X 

X 

X 

X 

X 

X 


The following section describes the output navigation qualifiers. 

/EXACT 

Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string 
that must match the search string exactly and must be enclosed with quotation 
marks (“ ”). 

If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search 
mode is enabled when you set the search string with the Find (El) key. 

/HEADER 

/NOHEADER 

Specifies whether a header line is placed at the top of each file that is displayed 
with the TYPE /PAGE=SAVE command. This qualifier is valid with the TYPE 
command only. 

/HIGHLIGHT[=keyword] 

/NOHIGHLIGHT (default) 

Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of 
highlighting you want when a search string is found. When a string is found, the 
entire line is highlighted. You can use the following keywords: BOLD, BLINK, 
REVERSE, and UNDERLINE. BOLD is the default highlighting. 

/PAGE[=keyword] 

/NOPAGE (default) 

Controls the display of directory information on the screen. 

You can use the following keywords with the /PAGE qualifier: 

CLEAR_SCREEN Clears the screen before each page is displayed. 

SCROLL Displays information one line at a time. 

SAVE [=7i] Enables screen navigation of information, where n is the 

number of pages to store. 

The /PAGE=SAVE qualifier allows you to navigate through screens of information. 
The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of 
information. When you use the /PAGE=SAVE qualifier, you can use the keys 
described in Table 2—6 to navigate through the information. 
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Table 2-6 Keys and Key Sequences Used to Navigate Through Screens 


Press 

To 

Up arrow (t) or Ctrl/B 

Scroll up one line. 

Down arrow ([ ) 

Scroll down one line. 

Left arrow (<— ) 

Scroll left one column. 

Right arrow (—*) 

Scroll right one column. 

Find (El) 

Specify a string to find when the information is displayed. 

Insert Here (E2) 

Scroll right one half screen. 

Remove (E3) 

Scroll left one half screen. 

Select (E4) 

Toggle 80/132 column mode. 

Prev Screen (E5) 

Get the previous page of information. 

Next Screen (E6) or 
Return or Enter or 

Space 

Get the next page of information. 

F10 or Ctrl/Z 

Exit. (Some utilities define these key sequences differently.) 

Help (F15) 

Display utility help text. 

Do (F16) 

Toggle the display to oldest/newest page. 

Ctrl/W 

Refresh the display. 

N 

Display the next file (when more than one file is specified with 
the TYPE command). 

Q 

Quit displaying output from the TYPE command. 


The /PAGE qualifier is not compatible with the /OUTPUT qualifier. 

/SEARCH="string" 

Use with the /PAGE=SAVE qualifier to specify a string that you want to find in 
the information being displayed. Quotation marks are required for the /SEARCH 
qualifier, if you include spaces in the text string. 

You can also dynamically change the search string by pressing the Find key (El) 
while the information is being displayed. Quotation marks are not required for a 
dynamic search. 

/WRAP 

/NOWRAP (default) 

Use with the /PAGE=SAVE qualifier to limit the number of columns to the width 
of the screen and to wrap lines that extend beyond the width of the screen to the 
next line. 

The /NOWRAP qualifier extends lines beyond the width of the screen and can 
be seen when you use the scrolling (left and right) features provided by the 
/PAGE=SAVE qualifier. 

2.3 DECwindows DECnet/OSI Full Names Support 

DECwindows Motif Version 1.2 for OpenVMS supports DECnet/OSI full names. 
DECnet/OSI supports names that have a hierarchical structure and are longer 
than those currently supported by DECnet Phase IV. The following components 
support DECnet/OSI full names: 

• Bookreader 
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• DECnet transport 

• DECterm 

• FileView 

• Session Manager 

• The DCL command SET DISPLAY 

For additional information about full names, see Section 3.5. 

2.4 Support for File Shelving 

OpenVMS VAX Version 6.1 supports the layered product, POLYCENTER HSM 
for OpenVMS Version 1.0. HSM is a file shelving facility that lowers the average 
cost of storing data that is rarely used. 

File shelving allows users and processes to move an inactive file to nearline or 
offline media transparently, and to return the file to online media when needed. 
Table 2-7 contains definitions of these three terms. 


Table 2-7 File Shelving Definitions 
Term Definition 


Online Data is stored so that it is immediately available to the user without 

storage human or robotic intervention. 


Offline Data is stored so that human intervention is required to make it available 

storage to the user. 


Nearline Data is stored so that the intervention of a robot is required to make it 

storage available to the user. 


2.5 Help Message Utility (MSGHLP) Additions 

The Help Message utility (MSGHLP) has three new features: 

• You can now specify a directory name in a search path. If no file name is 
associated with a directory, Help Message searches all .MSGHLP$DATA files 
in that directory. This allows you to add or delete files in a specified directory 
without having to change the search path definition. 

• You can specify /WORK_FILES=nn with /SORT in order to use work files on 
large sort operations that previously failed. 

• You can specify the new /SECTION_FILE qualifier to identify message section 
files to the system so that Help Message can interpret $STATUS values for 
messages pointed to by those files. See Section 2.5.1 for details. 

2.5.1 Accessing $STATUS Values for Uninstalled Messages 

Any messages that are not installed as part of the OpenVMS operating system 
cannot be equated with a value stored in $STATUS until they are recognized 
by the system. Such messages include user-supplied messages, third-party 
messages, and messages from layered products and certain other OpenVMS 
facilities. Your system manager may already have linked all the messages you 
need at the system level. If not, you can make these links in your own account. 
(System managers who want information about linking message section files at 
the system level should refer to the OpenVMS System Manager's Manual.) 
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Before linking such messages, determine whether you must frequently access 
them using the value in $STATUS or a value specified using the /STATUS 
qualifier. If not, the simplest alternative is to use the HELP/MESSAGE command 
and specify the message identifier or message text in the search string. 

If you prefer the convenience of having Help Message interpret a $STATUS 
value, there are two ways that you can make the system recognize uninstalled 
messages: 

• The simplest method is to use the SET MESSAGE command to link an 
unknown messages .EXE file. For example: 

$ SET MESSAGE TOOLS:[MYPROJJMYNEWMSG.EXE 

This command includes the messages pointed to by file MYNEWMSG.EXE 
as part of the system until you enter another SET MESSAGE command 
specifying a different file. 

• For a more permanent solution, execute the following command for every 
message section file that you would like to include in the list of files that Help 
Message automatically searches for $STATUS values: 

HELP/MESSAGE/SECTION_FILE=disk:[directory]file-name.EXE 

By default, /SECTION_FILE tries to generate or update object library 
SYS$LIBRARY:MSGHLP$MESSAGE_SECTIONS.OLB. Unless you 
have write access to system files, you must first define the logical name 
MSGHLP$MESSAGE_SECTIONS to point to your own account. 

For example, to make the messages pointed to by file 
TOOLS:[MYPROJ]MYNEWMSG.EXE known in your own account, use 
the following command sequence: 

$ DEFINE MSGHLP$MESSAGE_SECTIONS SYS$LOGIN:MSGHLP$MESSAGE_SECTIONS 
$ HELP/MESSAGE/SECTION_FILE=TOOLS:[MYPROJJMYNEWMSG.EXE 

Unlike the SET MESSAGE command, the /SECTION_FILE qualifier 
permanently links the specified message section file unless you later delete it. 

The default device and directory for the file specification is SYS$MESSAGE, 
where all OpenVMS message section files are stored, and the default file 
type is .EXE. Therefore, the following command automatically includes all 
OpenVMS message section files: 

$ help/message/section_file=*- 

Your system manager may already have included the OpenVMS message 
section files at the system level. You will need to add these only if you define 
the logical name MSGHLP$MESSAGE_SECTIONS to point somewhere other 
than SYS$LIBRARY:MSGHLP$MESSAGE_SECTIONS. 

Help Message can search a maximum of 42 message section files. Files are 
searched in the following order: 

• The last file activated by a SET MESSAGE command (if any). 

• The message section files that Help Message is linked with before it is 
shipped: 

- SYSMSG.EXE 

- SYSMGTMSG.EXE 

- CLIUTLMSG.EXE 
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- PRGMSG.EXE 

• Any message section files explicitly linked against MSGHLP$MAIN.EXE or 
any of the shareable images that it references. 

• Any nonduplicate message section files linked with a 
MSGHLP$MESSAGE_SECTIONS.EXE file, if such a file exists. 

The MSGHLP$MESSAGE_SECTIONS.EXE file is automatically generated 
from the MSGHLP$MESSAGE_SECTIONS.OLB file each time the 
HELP/MESSAGE command is executed with the /SECTION_FILE qualifier. 
Each execution of the /SECTION_FILE qualifier adds a module to the .OLB 
file; each module represents a message section file. 

Message section files are searched in the order in which they are listed in the 
.OLB file. (Order is alphabetical.) If the total count of message section files 
exceeds 42, message section files listed near the end of the .OLB file might 
not be searched. 

To display the contents of your .OLB file, use the following command: 

$ LIBRARY/LIST MSGHLP$MESSAGE_SECTIONS.OLB 

The names of the modules in this .OLB file are derived from strings specified 
in the /SECTION_FILE qualifier. 

You can remove references to message section files in the .OLB file in order 
to control which 42 message section files Help Message will search. For 
example, to delete the NCP (Network Control Program) messages from your 
private .OLB file, use the following command: 

$ LIBRARY/DELETE=NETWRKMSG MSGHLP$MESSAGE_SECTIONS.OLB 

If you delete a module from the .OLB file, you must execute the 
HELP/MESSAGE command with the /SECTION_FILE qualifier in order 
to generate an updated .EXE file. The qualifier argument can specify either a 
new file or a file that is already listed in the .OLB file. 

For complete information about the Help Message utility, refer to OpenVMS 
System Messages: Companion Guide for Help Message Users. 
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This chapter highlights new system management features for OpenVMS VAX 
Version 6.1. For detailed information about a feature, refer to the identified 
manuals in the OpenVMS documentation set. In addition, refer to the OpenVMS 
VAX Version 6.1 Release Notes for information about possible system impact. 

3.1 DECdtm Transaction Log Management 

The new Log Manager Control Program (LMCP) utility command, CLOSE LOG, 
lets you perform the following tasks without rebooting any nodes: 

• Change the size of a transaction log 

• Move a transaction log 

• Dismount a disk that has transaction logs 

• Disable DECdtm services 

For more detailed information, see the OpenVMS System Manager's Manual. 

3.2 ERRFMT and Event Notification 

The Error Formatter, ERRFMT, provides a new feature that allows you to 
send mail to a user if the ERRFMT process encounters a fatal error and 
deletes itself. Sending mail is enabled by default. However, two new system 
logical names ERRFMT$_SEND_MAIL and ERRFMT$_SEND_TO defined in 
SYS$STARTUP:VMS$CONFIG-050_ERRFMT.COM control this feature. See the 
OpenVMS System Manager's Manual for more information. 

3.3 Improvements to the File System 

PATHWORKS for OpenVMS users can take advantage of OpenVMS file system 
enhancements that provide performance improvements for PATHWORKS servers. 
The file system enhancements affect the OpenVMS extended QIO Processor 
(XQP), and are called the XQP+. 

Previously, the OpenVMS XQP+ file system enhancements were available 
on the PATHWORKS for VMS kits. With OpenVMS VAX Version 6.1, these 
enhancements are integrated into the OpenVMS operating system. 

The following table shows you which section to read, depending on whether you 
have the XQP+ on your system: 


If... 

Read... 

You do not have the XQP+ 

Section 3.3.1 

You already have the XQP+ 

Section 3.3.2 
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3.3.1 Performance Improvements 

Open VMS VAX Version 6.1 provides the following new features to improve the 
performance of the file system: 


New Feature Description 

Improved concurrency Allows multiple processes to create files on a single disk in 

parallel. Previously, only one process could create files on a 
disk at a time. 

Multiblock bitmap reads Reduces the time spent by the file system in allocating files. 


You can control improved concurrency using the static system parameter, 
XQPCTL2. Improved concurrency is off by default. To turn it on, set XQPCTL2 
to 1. 


_ Note _ 

In a VMScluster system, do not turn on improved concurrency unless 
all the nodes are running OpenVMS VAX Version 6.1 or OpenVMS AXP 
Version 6.1. 


3.3.2 Changes Affecting PATHWORKS 

Read this section if you are a PATHWORKS user with the XQP+ on your system. 

OpenVMS VAX Version 6.1 now includes the XQP+. There is only one change. 
The VMSD2 system parameter is replaced by two new system parameters, 
XQPCTLD1 and XQPCTL2. 


System Parameter 

Controls 

Values 

Default 

XQPCTLD1 

Multi-threading 

0 (off) and 8 (on) 

0 

XQPCTL2 

Improved concurrency 

0 (off) and 1 (on) 

0 


XQPCTLD1 is a dynamic system parameter; XQPCTL2 is static. 


_ Note _ 

If you are performing a rolling upgrade from OpenVMS VAX Version 
5.5-2 to OpenVMS VAX Version 6.1, turn off improved concurrency on all 
the nodes before you begin. 


3.4 Two New Qualifiers for the SHOW LICENSE Command 

Two new qualifiers are available for the SHOW LICENSE command. The 
/USAGE qualifier displays information on the current license use for a specific 
product installed on the system. It tells you how many license units are loaded, 
how many are currently allocated, and how many are currently available, as well 
as the license type. 

The /CLUSTER qualifier, in conjunction with the /UNIT_RE QUIRE ME NTS 
qualifier, displays the license unit requirements for every node in a VMScluster 
system. 
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For more detailed information, see the OpenVMS DCL Dictionary. 

3.5 Support for Full Names 

On OpenVMS VAX systems, naming conventions for DECnet node names 
correspond to the two types of DECnet functions that are available: 

• DECnet for OpenVMS VAX node names 

These names are used in the default version of DECnet shipped with the 
OpenVMS operating system. Refer to the DECnet for OpenVMS Networking 
Manual for more information. 

• DECnet/OSI full names 

Full names are hierarchically-structured DECnet node names that can be 
stored in a DECdns naming service. Full names on OpenVMS VAX systems 
can be a maximum of 255 bytes long. 

_ Note _ 

Full names are available only on OpenVMS VAX systems that are running 
DECnet/OSI. 


The network software checks and parses the name that you enter, whether it is a 
DECnet for OpenVMS VAX name or a DECnet/OSI full name. 

Full Names Syntax 

Full names have the following general syntax: 
namespace:.directory ... .directory.node-name 
where: 


namespace Identifies the global naming service 

directory ... .directory Defines the hierarchical directory path within the naming 

service 

node-name Is the specific object defining the DECnet node 

The node full name must begin with the namespace and a colon (:). The directory 
path must begin with a period (.). 

Example 

OMNI:.US.Massachusetts.Boston.RUBY 


In this example of a full name, OMNI is the name of a namespace in a global 
naming service; .US.Massachusetts.Boston is the directory path to the object, 
RUBY, which represents the node. 

The system stores a full name as you enter it, preserving uppercase and lowercase 
entries. However, when matching an entry with a stored full name, the system is 
not case sensitive; in other words, if the user enters Omni, the system recognizes 
it as equivalent to OMNI. 

Considerations for Assigning Full Names 

• Node full names must be unique within your network. 

• OpenVMS supports any type of node name except one containing an odd 
number of quotation marks (“ ”). 
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• You must place quotation marks (“ ”) around a node name under any of the 
following conditions: 

— The node name contains a space, tab, comma, left parenthesis, right 
parenthesis, quotation mark (“ ”), slash (/), exclamation point (!), plus 
sign (+), at sign (@), or single quote (’)• 

— The node name contains the character sequence of two colons 

— The node name starts or ends with a colon (:) character. 

• If a DECnet node name contains quotation marks, you must duplicate each 
quotation mark. Also, you must be sure to pair quotation marks within a full 
name. For example, the node name abc:"xyz" must appear as "abc:""xyz""". 

For information on full names and suggestions for setting up a system of names, 
see the OpenVMS System Manager's Manual: Tuning , Monitoring, and Complex 
Systems. 

For more information on DECnet/OSI, see the DECnet / OSI for OpenVMS 
Introduction , Planning , and Glossary manual. 

3.6 Monitoring Performance History Program Available 

Digital is committed to providing highly reliable systems. OpenVMS VAX Version 
6.1 includes the Monitoring Performance History (MPH) program that collects 
reliability data from systems being used in customer environments. The program 
periodically collects data and sends it to Digital for analysis. 

For more information about MPH and how to install it, please refer to the 
OpenVMS VAX Version 6.1 Release Notes. 

3.7 POLYCENTER Software Installation Utility 

The POLYCENTER Software Installation architecture is a new technology that 
simplifies the distribution and management of software. 

For system managers, the POLYCENTER Software Installation utility provides 
DIGITAL Command Language (DCL) and DECwindows Motif interfaces that they 
can use to configure, install, and remove software products. It also allows system 
managers to track the status of software on their system. 

For software providers, the POLYCENTER Software Installation utility simplifies 
the task of packaging software for the following reasons: 

• The utility provides a standard process and toolset for packaging products on 
all platforms. 

• All software and documentation can exist on single pieces of media. 

• The utility keeps track of which products (and versions) have been installed 
and removed in the execution environment. By using this information, you 
can design your installation procedure so that users can use the utility to 
manage version dependencies. 

• Installations require less code than most conventional installation methods. 
This results in performance gains and reduced development time over 
conventional installations. The code is also nonprocedural, which means that 
you do not need to understand the details of how the utility functions. 

• You can include installation text to guide users through an installation, 
resulting in a higher installation success rate. 
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For more detailed information, see the POLYCENTER Software Installation 
Utility User's Guide and the POLYCENTER Software Installation Utility 
Developer's Guide. 

3.8 New System Parameters for OpenVMS VAX 

Table 3-1 describes new system parameters for OpenVMS VAX Version 6.1. 


Table 3-1 New System Parameters 


Parameter 

Description 

SHADOW_SYS_TMO 

The SHADOW_SYS_TMO parameter has the following two 
distinct usages: 


• Use this parameter at system boot time, when this is the 
first node in the cluster to boot and to create this specific 
shadow set. If the proposed shadow set is not currently 
mounted in the cluster, use this parameter to extend the 
time a booting system waits for all former members of the 
shadowed system disk to become available. 


• Use this parameter once the system successfully mounts 
the virtual unit and begins normal operations. In this 
usage the SHADOW_SYS_TMO parameter controls the 
time the operating system waits for errant members of a 
system disk. (Use the SHADOW_MBR_TMO parameter to 
control the time the operating system waits for the errant 
members of an application disk.) 


This parameter applies only to members of the system disk 
shadow set. All nodes using a particular system disk shadow 
set should have their SHADOW_SYS_TMO parameter set to 
the same value once normal operations begin. 


The default value is 20 seconds. Change this parameter to 
a higher value if you want the system to wait more than the 
20-second default for all members to join the shadow set. You 
can set the parameter value to 20 through 65,535 seconds. 

SHADOW_SYS_WAIT 

Extends the time a booting system waits for all current 
members of a mounted shadowed system disk to become 
available to this node. The shadow set must already be 
mounted by at least one other cluster node for this parameter 
to take effect. 


The default value is 256 seconds. Change this parameter to 
a higher value if you want the system to wait more than the 
256-second default for all members to join the shadow set. You 
can set the parameter value to 1 through 65,535 seconds. 


For a listing of all system parameters, see the OpenVMS System Management 
Utilities Reference Manual 

3.9 Volume Shadowing Supported on OpenVMS AXP 

In addition to running on OpenVMS VAX systems, volume shadowing is now 
available on OpenVMS AXP systems. This means that you can implement 
volume shadowing in a VMScluster that contains both VAX and AXP systems. 

Volume shadowing licenses are now available on a per-disk basis, along with the 
traditional capacity (per CPU) licenses. 

For more detailed information, see Volume Shadowing for OpenVMS . 


3-5 




_ 4 

Programming Features 


This chapter highlights new programming features for OpenVMS VAX Version 
6.1. For detailed information about a feature, refer to the identified manuals in 
the OpenVMS documentation set. In addition, refer to the OpenVMS VAX Version 
6.1 Release Notes for information about possible system impact. 

4.1 LAT Symbiont Customization 

In previous versions of the OpenVMS operating system, you could modify a print 
symbiont but not a LAT symbiont. With this OpenVMS release, you can use 
the LAT protocol in a modified symbiont. This change has no effect on system 
management tasks such as setting up, creating, and managing queues. 

The programming interface to PSM$PRINT has been enhanced to include the 
ability to use the newly added LAT protocol. The following section describes the 
two new arguments. 


Format 


PSM$PRINT [streams] [,bufsiz] [,worksiz] [,maxqios] [,options] 

Arguments 

maxqios 

OpenVMS usage: longword_unsigned 
type: longword (unsigned) 

access: read only 

mechanism: by value 

Specifies the maximum number of outstanding $QIOs that a LAT symbiont 
stream will generate. The symbiont process quotas for the symbiont process must 
be large enough to handle the maximum number of QIOs, times the number of 
streams should all streams become stalled. Use a number between 2 and 32. 

Ten is suggested for normal printing capabilities; a larger number for high-speed 
printers. 


options 

OpenVMS usage: 

type: 

access: 

mechanism: 


longword_unsigned 
longword (unsigned) 
read only 
by reference 
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Longword bit vector that specifies symbiont options. The following is the valid 
option flag: 


Option 

Description 

PSM$V_LAT_PROTOCOL 

Specifies that the LAT protocol is used 


Note that using the LAT_PROTOCOL option carries the following restrictions: 

• Replacement of the output and job completion routines will be overridden. 

• The output device must be a LAT device. 

4.2 Convert/Reclaim Utility DCL Interface 

The DCL interface to the Convert/Reclaim utility has been enhanced. 

4.2.1 New /KEY Qualifier 

The /KEY qualifier to the DCL command CONVERT/RECLAIM allows the user 
to reclaim index file buckets for a specified key(s). If the user also requests 
statistics, they are reported separately for each specified key. Prior to this 
release, only key 0 index and data buckets were reclaimable. 

Use the following format: 

CONVERT/RECLAIM/KEY=(key_number[,...]) filename 

The default is to reclaim all bucket space and, if statistics are requested, to 
provide a single summary report. 

4.2.2 Display from CONVERT/RECLAIM/STATISTICS Command Enhanced 

The display format for CONVERT/RECLAIM/STATISTICS command now 
includes CPU and I/O statistics, similar to the display format for the CONVERT 
/STATISTICS command. 

4.3 Access to Convert Routines Options and Statistics 

Access to the options and statistics arrays used with the callable Convert and 
Convert/Reclaim utilities has been facilitated by defining the array elements as 
named longwords in a structure and by providing symbolic names for the element 
numbers. The $CONVDEF module in the STARLET macro library has been 
expanded to provide these symbolic definitions. 

4.3.1 Access to Qualifier Options Array 

Programmers using the callable Convert routine CONV$PASS_OPTIONS can 
now specify qualifiers to the CONVERT command using zero-based, symbolic 
offsets (CONV$K_...) into the variable-length array of longwords, which lists the 
qualifier options. The array is now also defined as a structure (CONV$OPTIONS) 
of named longwords (CONV$L_...) to support access by high-level programming 
languages. 

Table 4-1 lists the array elements by number and by symbol, and includes the 
default values for each qualifier option. Note that the first element contains the 
number of valid elements in the array. 
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Table 4-1 

CONVERT Options Array 



Array 

Element 

Symbolic Value 

Default Value 
(in Longwords) 

Default 

CONVERT 

Command 

Value 

0 

CONV$L_OPTIONS_COUNT 

No default 

N/A 

1 

CONV$L_CREATE 

1 

/CREATE 

2 

CONV$L_SHARE 

0 

/NOSHARE 

3 

CONV$L_FAST 

1 

/FAST_LOAD 

4 

CONV$L_MERGE 

0 

/NOMERGE 

5 

CONV$L_APPEND 

0 

/NOAPPEND 

6 

CONV$L_SORT 

1 

/SORT 

7 

CONV$L_WORK_FILES 

2 

/WORK 

FILES=2 

8 

CONV$L_KEY 

0 

/KEY=0 

9 

CONV$L_PAD 

0 

/NOPAD 

10 

CONV$L_PAD_CHARACTER 

0 

Pad 

character=0 

11 

CONV$L_TRUNCATE 

0 

/NOTRUNCATE 

12 

C ONV $L_EXIT 

0 

/NOEXIT 

13 

CONV$L_FKED_CONTROL 

0 

/NOFIXED 

CONTROL 

14 

CONV$L_FILL_BUCKETS 

0 

/NOFILL 

BUCKETS 

15 

CONV$L_READ_CHECK 

0 

/NOREAD 

CHECK 

16 

CONV$L_WRITE_CHECK 

0 

/NOWRITE 

CHECK 

17 

CONV$L_FDL 

0 

/NOFDL 

18 

CONV$L_EXCEPTION 

0 

/NOEXCEPTION 

19 

CONV$L_PROLOG 

No default 

System or 
process default 


4.3.2 Access to Conversion Statistics Array 

Programmers using the callable Convert routine CONV$CONVERT can now 
request conversion statistics using zero-based, symbolic offsets (CONV$K_...) into 
the variable-length array of longwords which contains the statistics. The array 
is now also defined as a structure (CONV$STATISTICS) of named longwords 
(CONV$L_...) to support access by high-level programming languages. 

Table 4-2 lists the array elements by number and by symbol. The first element 
is used to specify the number of statistics to return by array order. For example, 
if you assign the symbol CONV$L_STATISTICS_COUNT the value 2, the routine 
returns the statistics from the first two statistics elements: 

• Number of files converted 

• Number of records converted 
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Table 4-2 

Conversion Statistics Array 


Array 

Element 

Field Name 

Description 

0 

CONV$L_STATISTICS_COUNT 

Number of statistics 
specified 

1 

CONV$L_FILE_COUNT 

Number of files 

2 

CONV$L_RECORDS_COUNT 

Number of records 

3 

CONV$L_EXCEPTION_RECORDS_COUNT 

Number of exception 
records 

4 

CONV$L_VALID_RECORDS_COUNT 

Number of valid records 


4.3.3 Access to Reclamation Statistics Array 

Programmers using the callable Convert/Reclaim routine CONV$RECLAIM can 
now request reclamation statistics using zero-based, symbolic offsets 
(RECL$K_...) into the variable-length array of longwords which contains the 
statistics. The array is now also defined as a structure (RECL$STATISTICS) 
of named longwords (RECL$L_...) to support access by high-level programming 
languages. 

Table 4-3 lists the array elements by number and by symbol. The first element is 
used to specify one or more statistics by array order. For example, if you assign 
the symbol RECL$L_STATISTICS_COUNT the value 3, the routine returns the 
statistics from the first three statistics elements: 

• Data buckets scanned 

• Data buckets reclaimed 

• Index buckets reclaimed 


Table 4-3 Bucket Reclamation Statistics Array 


Array 

Element 

Field Name 

Description 

0 

RECL$L_STATISTICS_COUNT 

Number of statistics 
specified 

1 

RE CL$L_SC AN_C OUNT 

Data buckets scanned 

2 

RECL$L_DATA_COUNT 

Data buckets reclaimed 

3 

RECL$L_INDEX_COUNT 

Index buckets reclaimed 

4 

RECL$L_TOTAL_COUNT 

Total buckets reclaimed 


For more detailed information, see the OpenVMS Utility Routines Manual . 

4.4 CONV$RECLAIM Key Selection Parameter Added 

The CONV$RECLAIM key selection parameter has been added. 

The callable Convert/Reclaim utility routine CONV$RECLAIM now provides an 
optional parameter, keyjnumber , for selectively reclaiming buckets by key. If this 
parameter is omitted, or if the routine is passed a NULL value, reclamation is 
done for all keys in the file as in previous versions. If a valid key number for the 
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file is passed in this parameter, the reclamation is limited to the index and data 
buckets for the specified key. 

The following calling format includes the key selection parameter: 

CONV$RECLAIM input_filespec [,statistics_blk][,flags][,key_number] 

4.5 LOGINOUT Callout Routines 

The LOGINOUT callout routines enable user installations to merge site-specific 
login policies and events with OpenVMS LOGINOUT policies and events. 

With this release, the LOGINOUT callout routines have been added to user 
documentation. For details, see the OpenVMS Utility Routines Manual. 

4.6 OpenVMS Debugger New Features 

This section describes the following OpenVMS Debugger features, which are new 
in this release: 

• DECwindows Motif user interface enhancements 

• Connect/disconnect support 

• DCL DEBUG command enhancements 

• DECnet/OSI full names support 

• Heap Analyzer support 

• Online Help changes 

4.6.1 DECwindows Motif User Interface 

This version of the Debugger contains new DECwindows Motif interface features: 

• Single window design for most common operations 

The main window now includes the former source and control panel windows. 
A single menu bar contains the pulldown menus for this window. 

• Single window design for Breakpoint, Monitor, Register, and Tasking Views 

These views no longer appear within the control panel window but within 
their own optional view window. The Instruction View still appears in its own 
window with a separate menu bar. 

• Additional and adjusted pulldown menus and menu items 

These include a new Commands pulldown menu on the main window and 
Monitor and Register pulldown menus on the optional view window. The 
Options menu on the main window no longer lists individual views, but 
brings up a dialog box from which views can be chosen. 

• Editable source in a new window 

The editor is accessed from the Edit File item in the Commands pulldown 
menu on the main window. 

• Context-sensitive popups 

Context-sensitive popup menus can be accessed by positioning your mouse 
pointer in Debugger window panes and clicking MB2. Each popup allows you 
to issue commands and choose functions from a list of those available for the 
pane in which your mouse pointer is located. 
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• User overrides for radix and type information in Monitor and Register Views 
This feature was formerly available only through the command line. 

• Ability to expand and to modify breakpoints in the Breakpoint View 

The ability to modify breakpoints was formerly available only in the source 
display or command line. Breakpoint entries can now be expanded to show 
conditions and actions associated with the breakpoint. 

• Enhanced pushbutton customization 

The design of the Customize dialog box has been simplified. In addition, the 
ability to resequence the push buttons in the main window has been added. 

• Keypad support 

The following commands have been mapped to individual keys on the 
computer keypad: 


Command 

Key or Key Sequence 

Step/Line 

KPO 

Examine 

KP1 

Go 

KP comma 

Step/Into 

GOLD KPO 

Step/Over 

BLUE KPO 

Examine A 

GOLD KP1 

Show Calls 

KP5 

Show Calls 3 

GOLD KP5 


To issue one of these commands, press the key or key sequence indicated, 
followed by the Enter key on the keypad. 

You can change the commands represented by each key, or map commands 
to other keys on your keyboard, by customizing the EnterCmdOnCmdLine 
entry in the Debugger resource file. For more information, see the OpenVMS 
Debugger Manual. If you are mapping to other keys, you also need to consult 
the key designations listed in the KeySym Encoding chapter of the X and 
Motif Quick Reference Guide. 

4.6.2 Connect/Disconnect Support 

In this release, the CONNECT and DISCONNECT commands allow you to 
interrupt an image running in a separate process and to bring the image under 
Debugger control. After completion of debugging, you can then disconnect the 
Debugger from the process, allowing the process to continue to run without being 
under the control of the Debugger. 

In this release, you can connect to a process started by yourself or by anyone 
in your user identification code (UIC) group. To do this, include the /GROUP 
qualifier in the command that establishes your multiprocessing configuration: 

$ DEFINE/GROUP DBG$PROCESS MULTIPROCESS 

The CONNECT and DISCONNECT commands, like other debugger commands 
for debugging multiprocess programs, can be issued only from the debugger's 
command interface. These commands are disabled in the debugger's graphical 
user interface. 
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4.6.3 DCL DEBUG Command Enhancements 

In this release, two new qualifiers have been added to the DCL DEBUG 
command: /KEEP and /RESUME. 

The Kept Debugger is now invoked by issuing the following command at the DCL 
prompt: 

$ DEBUG/KEEP 

This replaces: 

$ RUN SYS$SHARE:DEBUGSHR 

Also, after executing Ctrl/Y to interrupt the character-cell debugger, you can 
resume your debugging session with the following DCL command: 

$ DEBUG/RESUME 

This replaces the command: 

$ DEBUG 

Note that the following key sequence commands are disallowed by the debugger 
(that is, they cause internal debugger errors): 

• RUN program-name/DEBUG, Ctrl/Y, and DEBUG/KEEP 

• DEBUG/KEEP, Ctrl/Y, and DEBUG/RESUME 

4.6.4 DECnet/OSI (Phase V) Full Names Support 

In previous releases, OpenVMS VAX supported DECnet-VAX (Phase IV) network 
node names. This included a number of restrictions, the most cumbersome of 
which was a length restriction of six characters. 

This version of the Debugger provides support for the more flexible 
DECnet/OSI (Phase V) full names network node names. For more information on 
full names, see Section 3.5. 


_ Note _ 

Full names are available only on OpenVMS VAX Version 6.1 systems that 
are running DECnet/OSI. 


4.6.5 Heap Analyzer Support 

The Heap Analyzer, a new debugger feature, provides a graphical representation 
of memory use in real time. By studying this representation, you can quickly 
identify areas in your application where memory usage and performance can be 
improved. For example, you might notice allocations that are made too often, 
memory blocks that are too large, evidence of fragmentation, or memory leaks. 

Once you have located an area of interest, you can request an enlarged, more 
detailed, or altered view. If you choose, you can see traceback or statistical 
information associated with an allocation. You can then display the source 
code associated with a particular allocation and correlate memory events with 
application code. 
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4.6.6 Online Help Changes 

Online Help has been enhanced in this release to contain full reference material. 
This material has been removed from the OpenVMS Debugger Manual. 

In addition, online Help is available through printable files in both text and 
postscript format as follows: 

SYS$HELP:DBG$HELP.PS 

SYS$HELP:DBG$HELP.TXT 

4.7 New Optional Argument Supported for Calls to FDL$CREATE 

The FDL$CREATE routine now accepts the name of the default FDL file or the 
default FDL specification as an optional routine call argument. The optional 
dflt_fdl_spc argument is the address of a character string descriptor pointing 
to either the default FDL file or the default FDL specification. If the FDL$V_ 
DEFAULT_STRING flag is set in the flags argument, FDL$CREATE interprets 
this argument as an FDL specification in string form. Otherwise, FDL$CREATE 
interprets this argument as an FDL file name. 

With this argument, you can specify default FDL attributes. FDL$CREATE 
processes the attributes specified in the character string descriptor, unless 
you override these attributes with the attributes you specify in the fdl_spec 
argument. 

You can also code the FDL defaults directly into your program, typically with an 
FDL specification in string form. 

This argument is optional. 

For more information, see the OpenVMS Utility Routines Manual. 

4.8 File Information Block (FIB) Changes 

As of this release of the OpenVMS operating system, fields, subfields, 
subfunctions, and major functions of the file information block (FIB) support 
both OpenVMS VAX systems and OpenVMS AXP systems. For more information, 
see the OpenVMS I/O User's Reference Manual. 

4.8.1 FIB$L_ACCTL (Access Control) Subfunctions 

Table 4-4 contains the subfields for FIB$L_ACCTL (access control) that are no 
longer OpenVMS VAX system specific. 


Table 4-4 FIB Fields (Access Control) 


Field 

Subfields 

Meaning 

FIB$L_ACCTL 


Specifies field values that control access to 
the file. The following access control bits are 
applicable to the access subfunction. 


FIB$V_CONTROL 

Set for control access. If this bit is set, you 
cannot access the file if you do not have control 
access. 


FIB$V_N Q_READ_DATA 

Set to deny read access to the file. 
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4.8.2 IO$_CREATE (Create File) Major Functions 

Table 4-5 contains the field and subfields of IO$_CREATE (create file) that are 
no longer OpenVMS VAX system specific. 


Table 4-5 IO$_CREATE and the File Information Block 


Field 

Subfields 

Meaning 

FIB$L_STATUS 


Access status. Programmers can control the security 
information being propagated as well as the source 
of this information by setting the following bits. 


FIB$V_DIRACL 

Propagate the ACL from the parent directory to the 
file, assuming the file is a directory file. 


FIB$V_EXCLPREVIOUS 

Set to indicate that propagation may not occur from 
a previous version of the file. 


FIB$V_ALIAS_ENTRY 

Set on any file system operation where the directory 
backlink in the file header is different (and nonzero) 
from the directory id specified in the FIB. 


FIB$V_NOCOPYACL 

Set to indicate that the ACL should not be 
propagated from the parent directory (or a previous 
version of the file) to the file. 


FIB$V_NOCOPYOWNER 

Set to indicate that the owner UIC should not be 
propagated from the parent directory (or a previous 
version of the file) to the file. 


FIB$V_NOCOPYPROT 

Set to indicate that the UlC-based protection should 
not be propagated from the parent directory (or a 
previous version of the file) to the file. 


FIB$V_PROPAGATE 

Propagate attributes from the parent directory (or 
previous version of the file). If you set the FIB$V 
NOCOPYACL, FIB$V_NOCOPYOWNER, or FIB$V_ 
NOCOPYPROT bits, you must also set FIB$V_ 
PROPAGATE or a SS$_BADPARAM error results. 


4.8.3 IO$_MODIFY (Modify File) Major Functions 

Table 4-6 contains the field and subfields of IO$_MODIFY (modify file) that are 
no longer OpenVMS VAX system specific. 

Table 4-6 IO$_MODIFY and the File Information Block 

Field Subfields Meaning 

FIB$L_STATUS Access status. Applies to all major functions. 

Programmers can control the security 
information being propagated as well as the 
source of this information by setting the 
following bits. 

FIB$V_DIRACL Propagate the ACL from the parent directory 

to the file, assuming the file is a directory file. 

FIB$V_EXCLPREVIOUS Set to indicate that propagation may not occur 

from a previous version of the file. 

(continued on next page) 
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Table 4-6 (Cont.) IO$_MODIFY and the File Information Block 


Field 

Subfields 

Meaning 


FIB$V_ALIAS_ENTRY 

Set on any file system operation where the 
directory backlink in the file header is different 
(and nonzero) from the directory id specified in 
the FIB. 


FIB$V_NOCOPYACL 

Set to indicate that the ACL should not be 
propagated from the parent directory (or a 
previous version of the file) to the file. 


FIB$V_NOCOPYOWNER 

Set to indicate that the owner UIC should not 
be propagated from the parent directory (or a 
previous version of the file) to the file. 


FIB$V_NOCOPYPROT 

Set to indicate that the UlC-based protection 
should not be propagated from the parent 
directory (or a previous version of the file) to 
the file. 


FIB$V_PROPAGATE 

Propagate attributes from the parent 
directory (or previous version of the file). If 
you set the FIB$V NOCOPYACL, FIB$V 
NOCOPYOWNER, or FIB$V_NOCOPYPROT 
bits, you must also set FIB$V_PROPAGATE or 
a SS$_BADPARAM error results. 


4.8.4 IO$M_MOVEFILE (Movefile) Subfunction 

The movefile subfunction is no longer Open VMS VAX system specific. For more 
information, see the OpenVMS I/O User’s Reference Manual. 

4.9 New LAN Drivers 

Table 4-7 lists the new LAN devices and drivers. 


Table 4-7 New LAN Devices and Drivers 


Device 

Bus 

Driver 

Device 

Name 

Device Type 

Medium 

^Digital Equipment 
FDDIcontroller (DEFAA) 

FUTUREBUS+ FADRIVER 

FAcO: 

DT$_FQ_DEFQA 

FDDI 

tDigital Equipment 

FDDIcontroller 

(DEFQA) 

Q-bus 

FQDRIVER 

FQcO: 

DT$_FA_DEFAA 

FDDI 

^Digital Equipment 

FDDIcontroller 

(DEFEA) 

EISA 

FRDRIVER 

FRcO: 

DT$_FR_DEFEA 

FDDI 


tVAX specific. 
tAXP specific. 


_ Note _ 

LAN devices always have a device class of DC$_SCOM. 


For more information, see the OpenVMS I/O User's Reference Manual. 
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4.10 RMS Reverse-Search Option 

For random, keyed access to an index file, RMS returns records with keys that 
have the same value as the specified search key, unless otherwise directed. Prior 
to this release, RMS provided two search key options: 

• RAB$M_EQNXT (RAB$M_KGE). This option returns records that have the 
same key value as the specified search key, or the next greater key value, 
according to the sort order for the current key of reference. 

• RAB$M_NXT (RAB$M_KGT). This option returns records that have the next 
greater key value, according to the sort order for the current key of reference. 

OpenVMS VAX Version 6.1 and OpenVMS AXP Version 6.1 introduce a search 
key option that reverses the direction of the search when used with the two 
existing search key options. When you specify the reverse-key (RAB$M_REV) 
option, RMS returns the previous record (next lower key) rather than the next 
record (next greater key). You can use the following combinations: 

• RAB$M_REV + RAB$M_EQNXT. This combination of search key options 
returns records that have the same key value as the specified search key, or 
the next lower key value, according to the sort order for the current key of 
reference. 

• RAB$M_REV + RAB$M_NXT. This combination of search key options returns 
records that have the next lower key value, according to the sort order for the 
current key of reference. 

In all cases, you specify search key options symbolically using the mask bits 
in the RAB$L_ROP field of the record access block (RAB) structure. Table 4-8 
identifies the results of all combinations of the REV, EQNXT, and NXT bits. 


Table 4-8 Keyed Search Combinations 


Search Result 

REV 

EQNXT 

NXT 

Equal (default) 

0 

0 

0 

Greater-than or equal 

0 

1 

0 

Greater-than (next) 

0 

0 

1 

RMS$_ROP error 

0 

1 

1 

RMS$_ROP error 

1 

0 

0 

Less-than or equal 

1 

1 

0 

Less than (previous) 

1 

0 

1 

RMS$_ROP error 

1 

1 

1 


You should consider the following design characteristics when choosing the 

reverse-search key option: 

• The reverse-search key option is restricted to keyed access to indexed files. 

• The reverse-search key option reverses the search direction for random keyed 
access only. Sequential access still proceeds forward only , according to the 
sort order. 

• When the previous record is one of a chain of duplicates, RMS returns the 
first record in the chain. 
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• Using the reverse-search option to retrieve successive records with duplicate 
keys requires additional compiler or application program logic. 

• On-disk data structures are designed to provide optimum performance for 
forward searches. Reverse search performance may be diminished, especially 
for applications that process long chains of deleted records. 

• A performance caching optimization has been built into the reverse-search 
option to improve performance when retrieving successive previous records. 

To take advantage of this feature, specify full key sizes (RAB$B_KSZ) and 
select the RAB$M_NXT search option. 

For more detailed information, see the OpenVMS Record Management Services 
Reference Manual and the Guide to OpenVMS File Applications. 

4.11 RMS Support for Shelving 

RMS provides the XABITM data structure for passing information between RMS 
and the application program using appropriate item codes. Two new item codes 
have been developed to do the following: 

• Indicate whether a file is shelved 

• Indicate whether a file can be shelved 

• Disallow shelving for a new file 

The XAB$_UCHAR_SHELVED item code senses whether a file is shelved. 

The XAB$_UCHAR_NOSHELVABLE item code can be used to sense whether a 
file can be shelved—or it can be used to prevent a new file from being shelved 
using the set function. Sensing is permitted as part of the $OPEN, $CREATE, 
and $DISPLAY services. You can only set a file to disallow shelving when you 
create the file using the $CREATE service. If you want to disallow shelving 
for an existing file, use the DCL command SET FILE/NOSHELVABLE (see the 
OpenVMS DCL Dictionary). 

These item codes are not supported for DECnet/OSI for OpenVMS operations. 

For more detailed information about RMS, see the OpenVMS Record Management 
Services Reference Manual. 

4.12 OpenVMS RTL Library (LIB$) Full Name Support 

DECnet/OSI (Phase V) full name processing is now available through the 
OpenVMS RTL Library (LIB$) facility. The new routines are listed in Table 4-9. 

Table 4-9 LIB$ Routines for Full Name Support 

Routine Name Function 

tLIB$BUILD_NODESPEC Build a node name specification. 

fLIB$COMPARE_NODENAME Compare two node names. 

tLIB$COMPRESS_NODENAME Compress a node name to its short form 

equivalence. 


tOpenVMS VAX specific. 


(continued on next page) 
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Table 4-9 (Cont.) LIBS Routines for Full Name Support 


Routine Name 

Function 

tLIB$EXPAND_N ODENAME 

Expand a node name to its full name 
equivalence. 

tLIB$FIT_NODENAME 

Fit a node name into an output field. 

tLIB$GET_FULLNAME_OFFSET 

Get the offset to the starting position of the 
most significant part of a full name. 

tLIB$GET_HOSTNAME 

Get host node name. 

tLIB$TRIM_FULLNAME 

Trim a full name to fit into a desired output 
field. 

tOpenVMS VAX specific. 


For complete information on each routine, see the OpenVMS RTL Library (LIB$) 
Manual. 

4.13 System Services 

This section contains information about new features for system services. For 
detailed information, see the OpenVMS System Services Reference Manual. 

4.13.1 $GETDVI System Service Enhancements 

Several new item codes for terminal devices have been added to OpenVMS VAX 
Version 6.1. 

Table 4—10 describes the new item codes for the $GETDVI system service. 


Table 4-10 New $GETDVI Item Codes 

Item Code Description 


DVI$_TT_CHARSET 
DVI$_TT_CS_HAN GUL 

D VI$_TT_C S_HANYU 

DVI$_TT_CS_HANZI 

DVI$_TT_CS_KANA 

DVI$_TT_CS_KANJI 

DVI$_TT_CS_THAI 


Returns the character sets supported by the terminal. 

Indicates whether or not the device supports the DEC 
Hangul coded character set. 

Indicates whether or not the device supports the DEC 
Hanyu coded character set. 

Indicates whether or not the device supports the DEC 
Hanzi coded character set. 

Indicates whether or not the device supports the DEC 
Kana coded character set. 

Indicates whether or not the device supports the DEC 
Kanji coded character set. 

Indicates whether or not the device supports the DEC 
Thai coded character set. 


For detailed information, see the OpenVMS System Services Reference Manual. 
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4.13.2 $FILESCAN System Service Enhancements 

Several enhancements have been made to the $FILESCAN system service in 
Open VMS VAX Version 6.1 to support full names. 

Two new arguments, auxout and retlen, have been added. The auxout 
argument can be used to specify an auxiliary output buffer into which 
$FILESCAN copies an entire source string. When you specify the auxout 
argument, quotation information is reduced and simplified for the primary node 
only. The retlen argument is the address of a word into which $FILESCAN 
writes the length of the auxiliary buffer string. 

Three new flag bits have been added to correspond with three new file 
specifications. Table 4-11 shows the file specification component that corresponds 
to the symbolic name of each flag bit. 


Table 4-11 New $FILESCAN Flag Bits 


Symbolic Name 

Corresponding Component 

FSCN$V_NODE_PRIMARY 

Primary (first) node name 

FSCN$V_NODE_ACS 

Access control string of primary node 

FSCN$V NODE 

Secondary (additional) node information 

SECONDARY 



In addition, three new item codes have been added. Table 4-12 describes the new 
item codes. 

Table 4-12 New $FILESCAN Item Codes 

Item Code Description 

FSCN$_NODE_PRIMARY Retrieves the primary node specification. 

FSCN$_NODE_ACS Retrieves the access control string. 

FSCN$_NODE_ Retrieves the secondary node specification. 

SECONDARY 


For detailed information, see the OpenVMS System Services Reference Manual. 

4.13.3 Security System Services 

OpenVMS VAX Version 6.1 includes new system services for the proxy and 
intrusion databases. 

4.13.3.1 System Services for the Proxy Database 

OpenVMS VAX Version 6.1 contains the following features for accessing the proxy 
database: 

• $ADD_PROXY 

The $ADD_PROXY system service adds a new proxy to, or modifies an 
existing proxy in, the proxy database. 

• $DELETE_PROXY 

The $DELETE_PROXY system service deletes an existing proxy or removes 
the default user or a local user from an existing proxy in the proxy database. 
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• $DISPLAY_PROXY 

The $DISLAY_PROXY system service returns information about one or more 
existing proxies. 

• $ VE RIF Y_PROXY 

The $VERIFY_PROXY system service verifies that a proxy exists and returns 
a valid local user for the caller to use to create a local login. 

For a complete description of these features, see the OpenVMS System Services 
Reference Manual. 

4.13.3.2 System Services for the Intrusion Database 

OpenVMS VAX Version 6.1 contains the following features for accessing the 
intrusion database: 

• $DELETE_INTRUSION 

The $DELETE_INTRUSION system service searches for and deletes all 
records in the intrusion database matching the caller’s specifications. 

• $SC AN_INTRU SION 

The $SCAN_INTRUSION system service scans the intrusion database for 
suspects or intruders during a login attempt, audits login failures and updates 
records, or adds new records to the intrusion database. 

• $SHOW_INTRUSION 

The $SHOW_INTRUSION system service searches for and returns 
information about records in the intrusion database matching the caller’s 
specifications. 

For detailed information, see the OpenVMS System Services Reference Manual. 

4,13.4 $SETSHLV System Service 

The $SETSHLV system service controls whether a process automatically 
unshelves files. For detailed information, see the OpenVMS System Services 
Reference Manual. 
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DECwindows Motif Display Server New 

Features 


The DECwindows Motif display server included with the OpenVMS VAX Version 
6.1 operating system includes several new features. This chapter describes those 
features. 

For more information about customizing and configuring your display server, see 
Managing DECwindows Motif for OpenVMS Systems in the DECwindows Motif 
Verison 1.2 for OpenVMS documentation set. 

5.1 DECwindows Server Customization Parameters 

In OpenVMS VAX Version 6.1 systems, several new symbols have been created 
that you can use to customize the DECwindows Motif display server. In previous 
versions of OpenVMS, these parameters could be defined using logical names. 

These customizations modify the default behavior of the DECwindows display 
server. Table 5-1 lists the new symbols for Version 6.1, a short description 
of what each parameter controls, and the default value. The parameters are 
grouped in Table 5—1 in the following areas: 

• Server process 

• Transport/connection 

• Fonts 

• Font caching 

• Keyboard 

• Screen saver 

• Mouse 

• Backing store 

• Error reporting 

To customize the DECwindows Motif display server environment, perform the 
following steps: 

1. Copy the template file 

SYS$COMMON: [SYSMGR]DECW$PRIVATE_SERVER_SETUP. TEMPLATE 
to SYS$COMMON:[SYSMGR]DECW$PRIVATEJ3ERVER_SETUP.COM. 

2. Edit the command file and search for the section entitled Cluster Common or 
Standalone Workstation Setup. 

3. Add any customizations in that section, as in the following example: 

$ DECW$SERVER_WSQUOTA == "2048" 
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4. Restart the DECwindows server with the following command: 

$ @SYS$STARTUP:DECW$STARTUP RESTART 

_ Caution _ 

Restarting the DECwindows server disconnects all current client 
processes. 


For a complete list of DECwindows display server parameters, descriptions, and 
customization examples, see Managing DECwindows Motif for OpenVMS Systems 
in the DECwindows Motif Version 1.2 for OpenVMS documentation set. 


Table 5-1 DECwindows Customization Parameters 


Parameter 

Description 

Default 

Server Process 

DECW$SERVER_WSDEF 

Defines process limits in pages. 

500 

DECW$SERVER_WSQUOTA 

Defines maximum amount of physical 
memory pages. 

1300 

DECW$SERVER_WSEXTENT 

Defines limit on physical memory pages. 

WSMAX 

DECW$SERVER_PAGE_FILE 

Defines the maximum amount of virtual 
memory. 

25000 

DECW$SERVER_FILE_LIMIT 

Defines the maximum number of files the 
server can open at one time. 

200 

DECW$SERVER_ENQUEUEJLIMIT 

Defines the maximum number of 
outstanding locks that are used in 
sharing resources, particularly files, 
between processes. 

512 

Transport Setup 

DECW$XPORT_SYNC_TIMEOUT 

Specifies which transports your server 
monitors for incoming connections. 

30000 

DECW$SERVER_RETRY_WRITE_TIMEOUT 

Defines the number of milliseconds at 
which time the DECwindows server stops 
attempting transport write requests. 

500 

DECW$SERVER_RETRY_WRITE_INTERVAL 

Defines the number of milliseconds 
between failed transport write-request 
attempts. 

30000 

Font Setup 

DECW$CURSOR_SIZE 

Defines which cursor font directories are 
included in the font path. It can be set to 
16 to include only the 16x16 cursors, or 

32 to include both the 32x32 and 16x16 

32 


cursor. 



1 Equal to the WSMAX system parameter 


(continued on next page) 
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Table 5-1 (Cont.) DECwindows Customization Parameters 


Parameter 

Description 

Default 

Font Caching Setup 

DECW$FM_INIT_NUM_CACHE_ROWS 

Defines the initial size of the cache, in 

60 


rows. 


DECW$FM_MAX_ROW_CACHE_SIZE 

Defines the maximum number of rows 
that can be allocated to the font cache. 

300 

DECW$FM_MIN_ROW_CACHE_SIZE 

Defines the minimum number of rows 
that can be allocated to the font cache. 

20 

DECW$FM_NO_CACHE_AUTOTUNING 

Determines whether the font cache is 
dynamic or static. The default value, 
false, enables autotuning so that all 
font cache symbols are active. If you set 
the symbol value to true, you disable 
autotuning. 

False 

DECW$FM_ROW_CACHE_EXTEND 

Defines the number of rows to be added 
to the font cache when the cache is full 
and another row must be read in from a 
font file. 

5 

DECW$FM_TIME_TO_SHRINK_CACHE 

Defines the number of seconds that a row 
is allowed to remain in the font cache 
without having been accessed, after 
which the row is removed unless the size 
of the cache has reached the minimum 
number of rows allowed. 

600 

Keyboard Setup 

DECW$SERVER_BELL_BASE_VOLUME 

Determines the bell volume of the 
keyboard. 

50 

DECW$SERVER_KEYCLICK_VOLUME 

Determines the key click volume of the 
keyboard. 

0 

DECW$SERVER_ENABLE_KB_AUTOREPEAT 

Causes a character to repeat itself 
automatically while a key is pressed. 

True 

DECW$SERVER_MAIN_KB_UPDOWN 

Defines whether the server receives 
reports of the down and up movements 
made by pressing the main keyboard 
keys. 

False 

Screen Saver Setup 

DECW$SERVER SCREEN SAVER PREFER 
BLANKING 

Determines the method by which screen 
saver is performed. When the value is 
True (the default), the DECwindows 
server causes the video device driver to 
turn off the video signal when the screen 
saver timeout expires. When the value is 
False, the DECwindows server clears the 
screen when the timeout expires. 

True 


(continued on 

next page) 
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Table 5-1 (Cont.) DECwindows Customization Parameters 


Parameter 

Description 

Default 

Screen Saver Setup 

DECW$SERVER_SCREEN_SAVER_TIMEOUT 

Defines the initial time (in seconds) 
before the screen saver is activated, after 
which the screen saver interval takes 
effect. 

600 

DECW$SERVER_SCREEN_SAVER_INTERVAL 

Defines the number of seconds the 
server waits before repainting the screen 
background. 

600 

Mouse Setup 

DECW$SERVER_MOUSE_THRESHOLD 

Defines the minimum motion of the 
mouse (in pixels) at which time the 
DECwindows server is notified of the 
motion. 

4 

Backing Store Setup 

DECW$SERVER_DEFAULT_BACKING_STORE 

Enables backing store of windows 
in three types of window states: (0) 
Indeterminate, depends on the server 
and the device being used; (1) Enable 
backing store only when window is 
mapped; (2) Enable backing store at all 
times. 

0 

DECW$SERVER_DISABLE_SAVE_UNDER 

Records window information that may be 
hidden when another window is placed 
on top. 

False 

Error Reporting Setup 

DECW$SERVER_DUMP 

Adds the /DUMP qualifier to the DCL 
command RUN causing a process dump 
if the server crashes. 

False 

DECW$CLIENT_ERROR_THRESHOLD 

Defines the number of protocol errors 
generated by a single client above which 
the client will be terminated. 

1 

DECW$SERVER_ERROR_THRESHOLD 

Defines the total number of server errors 
allowed before generating a warning 
message. 

10 


5.2 New Keymap Name Support 

Table 5-2 lists the new DECwindows Motif keymap names in the display server. 
The table is arranged based on the language for which each keyboard is designed 
and includes keyboard model numbers. 

For all other keymap names and information about changing the default keyboard 
layout, see Managing DECwindows Motif for OpenVMS Systems. 
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Table 5-2 New DECwindows Motif Keymap Names 

Language 

Model 

DECwindows Keymap Name 

Belgian/French 

LK201 

BELGIAN_FRENCH_LK201LP_DP 

Czech 

LK401 

CZECH_LK401_BV 

Polish 

LK401 

POLISH_LK401_BP 

Russian 

LK401 

RUSSIAN_LK401_BT 

Slovak 

LK401 

SLOVAK_LK401_CZ 


5.3 New Font Support 

This section lists the new font names that are included in the display server. 

Table 5-3 contains the Lucida Bright font names. 

Table 5-4 contains the Lucida Sans font names. 

Table 5-5 contains the Lucida Typewriter font names. 

Table 5-6 contains the VT330 font names. 

See the VMS DECwindows Guide to Xlib Programming: MIT C Binding for all 
other fonts included in the display server. 


Table 5-3 Lucida Bright Font Names 


.DECWSFONT File Name 


Font Name 


LUCID ABRIGHT08 

LUCIDABRIGHT10 

LUCIDABRIGHT12 

LUCIDABRIGHT14 

LUCIDABRIGHT18 

LUCIDABRIGHT19 

LUCIDABRIGHT24 

LUCIDABRIGHTJDEMI08 

LUCID ABRIGHT_DEMI 10 

LUCIDABRIGHT_DEMI 12 

LUCIDABRIGHT_DEMI 14 

LUCIDABRIGHT_DEMI18 

LUCID ABRIGHT_DEMI 19 

LUCIDABRIGHT_DEMI24 

LUCID ABRIGHT_ 
DEMIITALIC08 

LUCIDABRIGHT_ 
DEMIITALIC10 

LUCID ABRIGHT_ 
DEMIITALIC 12 

LUCIDABRIGHT_ 
DEMIITALIC 14 


-B&H-LucidaBright 
-B&H-LucidaBright 
-B&H-LucidaBright 
-B&H-LucidaBright 
-B&H-LucidaBright 
-B&H-LucidaBright 
-B&H-LucidaBright 
-B&H-LucidaBright 
-B&H-LucidaBright 
-B&H-LucidaBright 
-B&H-LucidaBright 
-B&H-LucidaBright 
-B &H-LucidaBright 
-B&H-LucidaBright 
-B&H-LucidaBright 


-Medium-R-Normal- -8-80-75-75-P-45-IS08859-1 
-Medium-R-Normal—10-100-75-75-P-56-IS08859-1 
-Medium-R-Normal- -12-120-75-75-P-68-IS08859-1 
-Medium-R-Normal- -14-140-75-75-P-80-ISO8859-1 
-Medium-R-Normal—18-180-75-75-P- 103-ISO8859-1 
-Medium-R-Normal—19-190-75-75-P-109-ISO8859-1 
-Medium-R-Normal- -24-240-75-75-P- 137-IS08859-1 
-DemiBold-R-Normal—8-80-75-75-P-47-IS08859-1 
-DemiBold-R-Normal—10-100-75-75-P-59-IS08859-1 
-DemiBold-R-Normal- -12-120-75-75-P-71-IS08859-1 
-DemiBold-R-Normal- -14-140-75-75-P-84-IS08859-1 
-DemiBold-R-Normal- -18-180-75-75-P- 107-ISO8859-1 
-DemiBold-R-Normal—19-190-75-75-P-114-ISO8859-1 
-DemiBold-R-Normal-24-240-75-75-P-143-ISO8859-l 
-DemiBold-I-Normal-8-80-75-75-P-48-ISO8859-l 


-B&H-LucidaBright-DemiBold-I-Normal—10-100-75-75-P-59-IS08859-1 
-B&H-LucidaBright-DemiBold-I-Normal-12-120-75-75-P-72-ISO8859-l 
-B&H-LucidaBright-DemiBold-I-Normal—14-140-75-75-P-84-ISO8859-1 

(continued on next page) 
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Table 5-3 (Cont.) Lucida Bright Font Names 

.DECW$FONT File Name Font Name 

LUCIDABRIGHT_ -B&H-LucidaBright-DemiBold-I-Normal--18-180-75-75-P-107-ISO8859-l 

DEMIITALIC18 

LUCIDABRIGHT_ -B&H-LucidaBright-DemiBold-I-Normal--19-190-75-75-P-114-ISO8859-l 

DEMIITALIC19 

LUCIDABRIGHT_ -B&H-LucidaBright-DemiBold-I-Normal--24-240-75-75-P-143-ISO8859-l 

DEMIITALIC24 

LUCID ABRIGHT_ITALIC08 -B&H-LucidaBright-Medium-I-Normal--8-80-75-75-P-45-ISO8859-l 

LUCIDABRIGHT_ITALIC10 -B&H-LucidaBright-Medium-I-Normal--10-100-75-75-P-57-IS08859-l 

LUCID ABRIGHT_ITALIC 12 -B&H-LucidaBright-Medium-I-Normal--12-120-75-75-P-67-ISO8859-l 

LUCIDABRIGHT_ITALIC 14 -B&H-LucidaBright-Medium-I-Normal-14-140-75-75-P-80-ISO8859-l 

LUCIDABRIGHT_ITALIC18 -B&H-LucidaBright-Medium-I-Normal--18-180-75-75-P-102-ISO8859-l 

LUCIDABRIGHT_ITALIC19 -B&H-LucidaBright-Medium-I-Normal--19-190-75-75-P-109-ISO8859-l 

LUCIDABRIGHT_ITALIC24 -B&H-LucidaBright-Medium-I-Normal--24-240-75-75-P-136-ISO8859-l 

LUCIDABRIGHT08_100DPI -B&H-LucidaBright-Medium-R-Normal--ll-80-100-100-P-63-IS08859-l 

LUCIDABRIGHT10_100DPI -B&H-LucidaBright-Medium-R-Normal--14-100-100-100-P-80-IS08859-l 

LUCID ABRIGHT12_100DPI -B&H-LucidaBright-Medium-R-Normal--17-120-100-100-P-96-IS08859-l 

LUCID ABRIGHT14_100DPI -B&H-LucidaBright-Medium-R-Normal-20-140-100-100-P-U4-IS08859-l 

LUCIDABRIGHT18_100DPI -B&H-LucidaBright-Medium-R-Normal--25-180-100-100-P-142-IS08859-l 

LUCID ABRIGHT19_100DPI -B&H-LucidaBright-Medium-R-Normal--26-190-100-100-P-149-IS08859-l 

LUCIDABRIGHT24_100DPI -B&H-LucidaBright-Medium-R-Normal-34-240-100-100-P-193-IS08859-l 

LUCIDABRIGHT_DEMI08_ -B&H-LucidaBright-DemiBold-R-Normal-ll-80-100-100-P-66-IS08859-l 

100DPI 

LUCIDABRIGHT_DEMI 10_ -B&H-LucidaBright-DemiBold-R-Normal-14-100-100-100-P-84-IS08859-l 

100DPI 

LUCIDABRIGHT_DEMI 12_ -B&H-LucidaBright-DemiBold-R-Normal-17-120-100-100-P-101-IS08859-l 

100DPI 

LUCIDABRIGHT_DEMI14_ -B&H-LucidaBright-DemiBold-R-Normal-20-140-100-100-P-118-IS08859-l 

100DPI 

LUCID ABRIGHT_DEMI18_ -B&H-LucidaBright-DemiBold-R-Normal-25-180-100-100-P-149-IS08859-l 

100DPI 

LUCIDABRIGHT_DEMI19_ -B&H-LucidaBright-DemiBold-R-Normal-26-190-100-100-P-155-IS08859-l 

100DPI 

LUCIDABRIGHT_DEMI24_ -B&H-LucidaBright-DemiBold-R-Normal-34-240-100-100-P-202-IS08859-l 

100DPI 

LUCIDABRIGHT_ -B&H-LucidaBright-DemiBold-I-Normal-11-80-100-100-P-66-ISO8859-1 

DEMIITALIC08_100DPI 

LUCIDABRIGHT_ -B&H-LucidaBright-DemiBold-I-Normal-14-100-100-100-P-84-IS08859-l 

DEMIITALIC 10_100DPI 

LUCID ABRIGHT_ -B&H-LucidaBright-DemiBold-I-Normal-17-120-100-100-P-101-IS08859-l 

DEMIITALIC 12_100DPI 

LUCID ABRIGHT_ -B&H-LucidaBright-DemiBold-I-Normal-20-140-100-100-P-119-IS08859-l 

DEMIITALIC 14_100DPI 

LUCID ABRIGHT_ -B&H-LucidaBright-DemiBold-I-Normal-25-180-100-100-P-149-IS08859-l 

DEMIITALIC 18_100DPI 

(continued on next page) 
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Table 5-3 (Cont.) Lucida Bright Font Names 

.DECWSFONT File Name Font Name 


LUCIDABRIGHT_ -B&H-LucidaBright-DemiBold-I-Normal~26-190-100-100-P-156-IS08859-l 

DEMIITALIC19_100DPI 

LUCID ABRIGHT_ -B&H-LucidaBright-DemiBold-I-Normal--34-240-100-100-P-203-IS08859-l 

DEMIITALIC24_100DPI 

LUCIDABRIGHT_ITALIC08_ -B&H-LucidaBright-Medium-I-Normal—11-80-100-100-P-63-IS08859-1 

100DPI 

LUCIDABRIGHT_ITALIC10_ -B&H-LucidaBright-Medium-I-Normal—14-100-100-100-P-80-IS08859-1 

100DPI 

LUCID ABRIGHT_ITALIC12_ -B&H-LucidaBright-Medium-I-Normal-17-120-100-100-P-96-IS08859-l 

100DPI 

LUCIDABRIGHT_ITALIC14_ -B&H-LucidaBright-Medium-I-Normal—20-140-100-100-P-113-IS08859-1 

100DPI 

LUCIDABRIGHT_ITALIC18_ -B&H-LucidaBright-Medium-I-Normal—25-180-100-100-P-142-IS08859-1 

100DPI 

LUCIDABRIGHT_ITALIC19_ -B&H-LucidaBright-Medium-I-Normal—26-190-100-100-P-148-IS08859-1 

100DPI 

LUCIDABRIGHT_ITALIC24_ -B&H-LucidaBright-Medium-I-Normal-34-240-100-100-P-194-IS08859-l 

100DPI 


Table 5-4 Lucida Sans Font Names 

.DECWSFONT File Name Font Name 

LUCIDA_ -B&H-Lucida-Bold-I-Normal-Sans-8-80-75-75-P-49-ISO8859-l 

BOLDITALICSANS08 

LUCIDA_ -B&H-Lucida-Bold-I-Normal-Sans-10-100-75-75-P-67-IS08859-l 

BOLDITALICSANSIO 

LUCIDA_ -B&H-Lucida-Bold-I-Normal-Sans-12-120-75-75-P-79-ISO8859-l 

BOLDITALICSANS12 

LUCIDA_ -B&H-Lucida-Bold-I-Normal-Sans-14-140-75-75-P-92-ISO8859-l 

BOLDITALICSANS14 

LUCIDA_ -B&H-Lucida-Bold-I-Normal-Sans-18-180-75-75-P-119-ISO8859-l 

BOLDITALICSANS18 

LUCIDA_ -B&H-Lucida-Bold-I-Normal-Sans-19-190-75-75-P-122-ISO8859-l 

BOLDITALICSANS19 

LUCIDA_ -B&H-Lucida-Bold-I-Normal-Sans-24-240-75-75-P-151-ISO8859-l 

BOLDITALICSANS24 

LU C ID A_B OLDS AN SO 8 -B&H-Lucida-Bold-R-Normal-Sans-8-80-75-75-P-50-ISO8859-l 

LUCIDA_BOLDSANS10 -B&H-Lucida-Bold-R-Normal-Sans-10-100-75-75-P-66-IS08859-l 

LUCIDA_BOLDSANS12 -B&H-Lucida-Bold-R-Normal-Sans-12-120-75-75-P-79-ISO8859-l 

LUCIDA_BOLDSANS14 -B&H-Lucida-Bold-R-Normal-Sans-14-140-75-75-P-92-ISO8859-l 

LUCIDA_BOLDSANS18 -B&H-Lucida-Bold-R-Normal-Sans-18-180-75-75-P-120-ISO8859-l 

LUCID A_BOLDSANS 19 -B&H-Lucida-Bold-R-Normal-Sans-19-190-75-75-P-122-ISO8859-l 

LUCIDA_BOLDSANS24 -B&H-Lucida-Bold-R-Normal-Sans-24-240-75-75-P-152-ISO8859-l 

LUCIDA_ITALICSANS08 -B&H-Lucida-Medium-I-Normal-Sans-8-80-75-75-P-45-ISO8859-l 

(continued on next page) 
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.DECW$FONT File Name Font Name 

LUCIDA_ITALICSANS 10 -B&H-Lucida-Medium-I-Normal-Sans-10-100-75-75-P-59-IS08859-l 

LUCID A_ITALICSANS 12 -B&H-Lucida-Medium-I-Normal-Sans-12-120-75-75-P-71-ISO8859-l 

LUCIDA_ITALICSANS14 -B&H-Lucida-Medium-I-Normal-Sans-14-140-75-75-P-82-ISO8859-l 

LUCIDA_ITALICSANS18 -B&H-Lucida-Medium-I-Normal-Sans-18-180-75-75-P-105-ISO8859-l 

LUCID A.ITALICSANS 19 -B&H-Lucida-Medium-I-Normal-Sans-19-190-75-75-P-108-ISO8859-l 

LU C ID A_ITALIC SAN S24 -B&H-Lucida-Medium-I-Normal-Sans-24-240-75-75-P-136-ISO8859-l 

LUCIDA_SANS08 -B&H-Lucida-Medium-R-Normal-Sans-8-80-75-75-P-45-ISO8859-l 

LUCIDA_SANS10 -B&H-Lucida-Medium-R-Normal-Sans-10-100-75-75-P-58-IS08859-l 

LUCIDA_SANS12 -B&H-Lucida-Medium-R-Normal-Sans-12-120-75-75-P-71-ISO8859-l 

LUCIDA_SANS14 -B&H-Lucida-Medium-R-Normal-Sans-14-140-75-75-P-81-ISO8859-l 

LUCID A_SANS 18 -B&H-Lucida-Medium-R-Normal-Sans-18-180-75-75-P-106-ISO8859-l 

LUCIDA_SANS19 -B&H-Lucida-Medium-R-Normal-Sans-19-190-75-75-P-108-ISO8859-l 

LUCID A_SANS24 -B&H-Lucida-Medium-R-Normal-Sans-24-240-75-75-P-136-ISO8859-l 

LUCIDA_ -B&H-Lucida-Bold-I-Normal-Sans-ll-80-100-100-P-69-IS08859-l 

BOLDITALICSANS08_100DPI 

LUCIDA. -B&H-Lucida-Bold-I-Normal-Sans-14-100-100-100-P-90-IS08859-l 

BOLDITALICSANSIO.IOODPI 

LUCIDA. -B&H-Lucida-Bold-I-Normal-Sans-17-120-100-100-P-108-IS08859-l 

BOLDITALICSANS12.100DPI 

LUCIDA. -B&H-Lucida-Bold-I-Normal-Sans-20-140-100-100-P-127-IS08859-l 

BOLDITALICSANS14.100DPI 

LUCIDA. -B&H-Lucida-Bold-I-Normal-Sans-25-180-100-100-P-159-IS08859-l 

BOLDITALICSAN S 18.100DPI 

LUCIDA. -B&H-Lucida-Bold-I-Normal-Sans-26-190-100-100-P-166-IS08859-l 

BOLDITALICSANS19.100DPI 

LUCIDA. -B&H-Lucida-Bold-I-Normal-Sans-34-240-100-100-P-215-IS08859-l 

BOLDITALICSANS24.100DPI 

LUCIDA.BOLDSANS08. -B&H-Lucida-Bold-R-Normal-Sans-U-80-100-100-P-70-IS08859-l 

100DPI 

LUCID A.BOLDSANS 10. -B&H-Lucida-Bold-R-Normal-Sans-14-100-100-100-P-89-IS08859-l 

100DPI 

LUCIDA.BOLDSANS12. -B&H-Lucida-Bold-R-Normal-Sans-17-120-100-100-P-108-IS08859-l 

100DPI 

LUCIDA.BOLDSANS14. -B&H-Lucida-Bold-R-Normal-Sans-20-140-100-100-P-127-IS08859-l 

100DPI 

LUCIDA.BOLDSANS18. -B&H-Lucida-Bold-R-Normal-Sans-25-180-100-100-P-158-IS08859-l 

100DPI 

LUCIDA.BOLDSANS19. -B&H-Lucida-Bold-R-Normal-Sans-26-190-100-100-P-166-IS08859-l 

100DPI 

LUCIDA.BOLDSANS24. -B&H-Lucida-Bold-R-Normal-Sans-34-240-100-100-P-216-IS08859-l 

100DPI 

LUCIDA.ITALICSANS08. -B&H-Lucida-Medium-I-Normal-Sans-ll-80-100-100-P-62-IS08859-l 

100DPI 

(continued on next page) 


5-8 


DECwindows Motif Display Server New Features 

5.3 New Font Support 



Lucida Sans Font Names 


.DECWSFONT File Name Font Name 


LUCIDA_ITALICSANS10_ -B&H-Lucida-Medium-I-Normal-Sans-14-100-100-100-P-80-IS08859-l 

100DPI 

LUC IDA_ITALIC SANS 12_ -B&H-Lucida-Medium-I-Normal-Sans-17-120-100-100-P-97-IS08859-l 

100DPI 

LU C ID A_ITALI C SAN S14_ -B&H-Lucida-Medium-I-Normal-Sans-20-140-100-100-P-U4-IS08859-l 

100DPI 

LU C ID A_ITALI C SAN S18_ -B&H-Lucida-Medium-I-Normal-Sans-25-180-100-100-P-141-IS08859-l 

100DPI 

LUCIDA_ITALICSANS19_ -B&H-Lucida-Medium-I-Normal-Sans-26-190-100-100-P-147-IS08859-l 

100DPI 

LUCIDA_ITALICSANS24_ -B&H-Lucida-Medium-I-Normal-Sans-34-240-100-100-P-192-IS08859-l 

100DPI 

LUCID A_SANS08_100DPI -B&H-Lucida-Medium-R-Normal-Sans-ll-80-100-100-P-63-IS08859-l 

LUCIDA_SANS10_100DPI -B&H-Lucida-Medium-R-Normal-Sans-14-100-100-100-P-80-IS08859-l 

LUCIDA_SANS12_100DPI -B&H-Lucida-Medium-R-Normal-Sans-17-120-100-100-P-96-IS08859-l 

LUCIDA_SANS14_100DPI -B&H-Lucida-Medium-R-Normal-Sans-20-140-100-100-P-114-IS08859-l 

LUCIDA_SANS18_100DPI -B&H-Lucida-Medium-R-Normal-Sans-25-180-100-100-P-142-IS08859-l 

LUCIDA_SANS19_100DPI -B&H-Lucida-Medium-R-Normal-Sans-26-190-100-100-P-147-IS08859-l 

LUCIDA_SANS24_100DPI -B&H-Lucida-Medium-R-Normal-Sans-34-240-100-100-P-191-IS08859-l 



Table 5-5 Lucida Typewriter Font Names 

.DECWSFONT File Name Font Name 


LUCID ATYPEWRITER_ 
BOLDSANS08 

LUCIDATYPEWRITER_ 

BOLDSANSIO 

LUCIDATYPEWRITER_ 

BOLDSANS12 

LUCID ATYPEWRITER_ 
BOLDSANS14 

LUCIDATYPEWRITER_ 

BOLDSANS18 

LUCID ATYPEWRITER_ 
BOLDSANS19 

LUCIDATYPEWRITER_ 

BOLDSANS24 

LUCIDATYPEWRITER_ 

SANS08 

LUCIDATYPEWRITER_ 
SANS 10 

LUCID ATYPEWRITER_ 
SANS 12 

LUCID ATYPEWRITER_ 
SANS 14 



-B&H-LucidaTypewriter-Bold-R-Normal-Sans-8-80-75-75-M-50-ISO8859-1 

-B&H-LucidaTypewriter-Bold-R-Normal-Sans-10-100-75-75-M-60-IS08859-l 

-B&H-LucidaTypewriter-Bold-R-Normal-Sans-12-120-75-75-M-70-ISO8859-l 

-B&H-LucidaTypewriter-Bold-R-Normal-Sans-14-140-75-75-M-90-ISO8859-l 

-B&H-LucidaTypewriter-Bold-R-Normal-Sans-18-180-75-75-M-110-ISO8859-l 

-B&H-LucidaTypewriter-Bold-R-Normal-Sans-19-190-75-75-M-110-ISO8859-l 

-B&H-LucidaTypewriter-Bold-R-Normal-Sans-24-240-75-75-M-140-ISO8859-l 

-B&H-Lucida r Typewriter-Medium-R-Normal-Sans-8-80-75-75-M-50-ISO8859-l 

-B&H-LucidaTypewriter-Medium-R-Normal-Sans-10-100-75-75-M-60-IS08859-l 

-B&H-LucidaTypewriter-Medium-R-Normal-Sans-12-120-75-75-M-70-ISO8859-l 

-B&H-LucidaTypewriter-Medium-R-Normal-Sans-14-140-75-75-M-90-ISO8859-l 

(continued on next page) 
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Table 5-5 (Cont.) Lucida Typewriter Font Names 

.DECW$FONT File Name Font Name 


LUCIDATYPEWRITER_ -B&H-LucidaTypewriter-Medium-R-Normal-Sans-18-180-75-75-M-110-ISO8859-l 

SANS 18 

LUCIDATYPEWRITER_ -B&H-Lucidaiypewriter-Medium-R-Normal-Sans-19-190-75-75-M-110-ISO8859-l 

SANS 19 

LUCID ATYPEWRITER_ -B&H-LucidaTypewriter-Medium-R-Normal-Sans-24-240-75-75-M-140-ISO8859-l 

SANS24 

LU C ID ATYPE WRITE R_ -B&H-LucidaTVpewriter-Bold-R-Normal-Sans-ll-80-100-100-M-70-IS08859-l 

BOLDSANS08_100DPI 

LUCIDATYPEWRITER_ -B&H-Lucida'IVpewriter-Bold-R-Normal-Sans-14-100-100-100-M-80-IS08859-l 

BOLDSANS10_100DPI 

LUCIDATYPEWRITER_ -B&H-LucidaTypewriter-Bold-R-Normal-Sans-17-120-100-100-M-100-IS08859-l 

BOLDSANS12_100DPI 

LUCIDATYPEWRITER_ -B&H-LucidaTypewriter-Bold-R-Normal-Sans-20-140-100-100-M-120-IS08859-l 

BOLDSANS14_100DPI 

LUCIDATYPEWRITER_ -B&H-Lucidaiypewriter-Bold-R-Normal-Sans-25-180-100-100-M-150-IS08859-l 

BOLDSANS18_100DPI 

LUCIDATYPEWRITER_ -B&H-LucidaTypewriter-Bold-R-Normal-Sans-26-190-100-100-M-159-IS08859-l 

BOLDSAN S 19_100DPI 

LUCID ATYPE WRITER_ -B&H-LucidaTypewriter-Bold-R-Normal-Sans-34-240-100-100-M-200-IS08859-l 

BOLDSANS24_100DPI 

LUCID ATYPEWRITER_ -B&H-LucidaIVpewriter-Medium-R-Normal-Sans-ll-80-100-100-M-70-IS08859-l 

SANS08_100DPI 

LUCIDATYPEWRITER_ -B&H-LucidaTypewriter-Medium-R-Normal-Sans-14-100-100-100-M-80-IS08859-l 

SANS10_100DPI 

LUC ID ATYPE WRITER_ -B&H-LucidaTVpewriter-Medium-R-Normal-Sans-17-120-100-100-M-100-IS08859-l 

SANS12_100DPI 

LUCIDATYPEWRITER_ -B&H-LucidaTypewriter-Medium-R-Normal-Sans-20-140-100-100-M-120-IS08859-l 

SANS14_100DPI 

LUCIDATYPEWRITER. -B&H-LucidaTypewriter-Medium-R-Normal-Sans-25-180-100-100-M-150-IS08859-l 

SANS18_100DPI 

LUCID ATYPEWRITER_ -B&H-LucidaIVpewriter-Medium-R-Normal-Sans-26-190-100-100-M-159-IS08859-l 

SANS 19_100DPI 

LUCIDATYPEWRITER_ -B&H-LucidaTypewriter-Medium-R-Normal-Sans-34-240-100-100-M-200-IS08859-l 

SANS24_100DPI 


Table 5-6 VT330 Font Names 

.DECWSFONT File Name Font Name 

VT33018 -DEC-VT330-Medium-R-Normal--20-180-75-75-C-100-IS08859-l 

VT33036 -DEC-VT330-Medium-R-Normal—40-360-75-75-C-200-IS08859-1 

VT330_BOLD18 -DEC-VT330-Bold-R-Normal-20-180-75-75-C-100-IS08859-l 

VT330_BOLD36 -DEC-VT330-Bold-R-Normal-40-360-75-75-C-200-IS08859-l 

VT330_BOLD_DBLWIDE 18 -DEC-VT330-Bold-R-Double Wide-20-180-75-75-C-200-IS08859-l 

VT330_BOLD_DBLWIDE_ -DEC-VT330-Bold-R-Double Wide-20-180-75-75-C-200-DEC-DECtech 

DECTECH18 

(continued on next page) 


5-10 



DECwindows Motif Display Server New Features 

5.3 New Font Support 

Table 5-6 (Cont.) VT330 Font Names 

-DECWSFONT File Name Font Name 

VT330_BOLD_DECTECH18 -DEC-VT330-Bold-R-Normal-20-180-75-75-C-100-DEC-DECtech 

VT330_BOLD_DECTECH36 -DEC-VT330-Bold-R-Normal-40-360-75-75-C-200-DEC-DECtech 

VT330_BOLD_NARROW 18 -DEC-VT330-Bold-R-Narrow-20-180-75-75-C-60-IS08859-l 

VT330_BOLD_NARROW36 -DEC-VT330-Bold-R-Narrow-40-360-75-75-C-120-IS08859-l 

VT330_BOLD_NARROW_ -DEC-VT330-Bold-R-Narrow-20-180-75-75-C-60-DEC-DECtech 

DECTECH18 

VT330_B OLD_N ARRO W_ -DEC-VT330-Bold-R-Narrow-40-360-75-75-C-120-DEC-DECtech 

DECTECH36 

VT330_BOLD_WIDE 18 -DEC-VT330-Bold-R-Wide-20-180-75-75-C-120-IS08859-l 

VT330_BOLD_WIDE_ -DEC-VT330-Bold-R-Wide-20-180-75-75-C-120-DEC-DECtech 

DECTECH18 

VT330_DBLWIDE 18 -DEC-VT330-Medium-R-Double Wide--20-180-75-75-C-200-IS08859-l 

VT330_DBLWIDE_ -DEC-VT330-Medium-R-Double Wide-20-180-75-75-C-200-DEC-DECtech 

DECTECH18 

VT330_DECTECH18 -DEC-VT330-Medium-R-Normal-20-180-75-75-C-100-DEC-DECtech 

VT330_DECTECH36 -DEC-VT330-Medium-R-Normal-40-360-75-75-C-200-DEC-DECtech 

VT330_NARROW18 -DEC-VT330-Medium-R-Narrow-20-180-75-75-C-60-IS08859-l 

VT330_NARROW36 -DEC-VT330-Medium-R-Narrow-40-360-75-75-C-120-IS08859-l 

VT330_NARROW_ -DEC-VT330-Medium-R-Narrow-20-180-75-75-C-60-DEC-DECtech 

DECTECH18 

VT330_NARROW_ -DEC-VT330-Medium-R-Narrow-40-360-75-75-C-120-DEC-DECtech 

DECTECH36 


VT330_WIDE 18 
VT330_WIDE_DECTECH18 


-DEC-VT330-Medium-R-Wide--20-180-75-75-C-120-IS08859-l 
-DEC-VT330-Medium-R-Wide—20-180-75-75-C-120-DEC-DECtech 
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Programming Support for SCSI-2 Devices 


This chapter expands the SCSI class and port driver support documentation 
provided in the Version 6.0 OpenVMS VAX Device Support Manual and the 
OpenVMS VAX Device Support Reference Manual to include support for the 
SCSI-2 device driver programming. 

On VAX systems, OpenVMS now supports the tagged command queuing 
architecture of the SCSI-2 standard and provides an extended OpenVMS SCSI 
port interface (SPI$) for SCSI-2 devices interfaced to an NCR 53C94 controller. 
Tagged command queuing allows the class driver to pass multiple queued I/O 
requests directly to the port driver without waiting for any one I/O to complete. 
The port driver then sends each I/O request directly to the target device, where 
the device queues the request on its internal command device queue. (See 
Figure 6—1.) 

The port-queue architecture increases I/O delivery to an internal SCSI-2 device 
queue allowing the device to optimize its operation. A device can improve 
performance by optimizing the operation of a set of I/O requests received against 
the known hardware capabilities (dynamic positioning and latency schedules, 
and spindle configuration). Also, any new pending I/O in the device queue begins 
immediately upon completion of the current I/O without waiting for the I/O status 
to be returned to the class driver. 

6.1 SCSI-2 Driver Design Considerations 

The SCSI class driver allocates and builds a SCSI class driver request packet 
(SCDRP) for each I/O request, passing the address to the port driver. The 
SCDRP contains the addresses of the unit control block (UCB), SCSI connection 
descriptor table (SCDT), I/O request packet (IRP), and critical IRP data. Once the 
port driver queues the I/O, the class driver thread is suspended. The port driver 
executes the I/O completion sequence. Figure 6-1 illustrates the queues and data 
structures in the tagged command queuing class/port architecture. 

As shown in Figure 6-1, the class driver utilizes the existing UCB busy queue 
(UCB$L_IOQFL) for some stalling situations. The port driver manages I/O 
requests using two queues: 

• Incoming port queue 

• In-device port queue 

The incoming port queue holds I/O requests received from the class driver. I/O 
requests from the incoming queue are then sent to the device via the SCSI bus 
and are also moved to the in-device port queue to track pending I/O in the 
device. In addition, SCSI-2 devices have their own device queue. Note that when 
the device reports a queue full status, some incoming requests will be stalled in 
the incoming port queue. 
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Figure 6-1 Class/Port Tagged Command Queuing Model 

Class Driver Responsibility 



ZK-6513A-GE 

With tagged command queuing, the port driver handles events such as a full 
device queue. The port driver must requeue the overflow of requests in the 
incoming port queue until the device is ready to receive more commands. When 
the device becomes ready, the port driver sends the next command in the 
incoming queue to the device. 
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To support the $CANCEL system service, your class driver must have a cancel 
I/O entry point and be able to account for all outstanding I/O. Outstanding I/O 
can be located in the following: 

• Port driver queues and the device queue 

• Resource wait queue 

• UCB$L_IOQFL busy queue 

The port driver must ensure that all threads in a resource wait state are returned 
in an error condition (but not necessarily in the order received). 

Since SCSI-1 level devices may not handle the ABORT message properly, your 
existing SCSI-1 type port drivers may not issue the ABORT message. However, 
most SCSI-2 devices conform to the SCSI-2 specification. Therefore, port drivers 
should implement the ABORT mechanism to SCSI-2 devices. 

6.2 Using the UCB$M_BSY Bit in a $QIO 

When a $QIO system service posts a new I/O, the $QIO sets the UCB$M_BSY 
(busy) bit. The class driver STARTIO routine clears this bit for I/O requests that 
it queues to the port driver. If a $QIO posts another I/O before the queued I/O 
completes, the $QIO again sets the busy bit and the class driver subsequently 
clears it again. Clearing the busy bit in STARTIO bypasses the system wait 
cycle for I/O completion. This sequence can continue until a condition occurs that 
causes the class driver to leave the busy bit set (for example, error recovery in 
progress or mount verification). In such cases, a $QIO will queue the new I/O to 
the UCB busy queue (pointer is UCB$L_IOQFL) as in the standard OpenVMS 
driver sequence. 

As I/O completes, the port driver resumes the appropriate class driver thread to 
complete the I/O to the user process. At I/O post-processing time, the class driver 
checks for I/O on the UCB busy queue using UCB$L_IOQFL. (See Figure 6-1.) 

If this list is not empty, the class driver initiates the next I/O on the list to the 
STARTIO routine. The STARTIO routine may then post the I/O to the port 
driver. If STARTIO clears the busy bit, the class driver continues to process the 
UCB busy queue until the list is empty or it encounters a request that does not 
clear the busy bit. 

6.3 Mixing Queued and Non-Queued I/O Requests 

Specifically, the port driver must support the SCSI-2 mechanism and protocol 
queuing requests to the device when required. Additionally, the class driver must 
also detect if a device is a SCSI-1 or a SCSI-2 command queuing device and post 
I/O requests to the port driver as appropriate. 

Because the infinite I/O queue is in the SCSI-2 port layer, the class driver sends 
all I/O requests to the port driver, whether the I/Os can be queued in the device 
or not. A SCSI port interface (SPI) routine (SPI$QUEUE_COMMAND) for 
queuing an I/O request to the port driver allows the class driver to specify to the 
port driver the queuing characteristics (SCDRP$W_QUEUE_CHAR) of the I/O 
request. The following are the queuing characteristics: 

• Ordered queuing 

• Unordered queuing 

• Head of port queue 

• Non-queued I/O 
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• Error recovery 

Ordered queuing makes an I/O request a queue barrier. All requests sent 
before the barrier request are completed first. Next, the barrier request is 
completed. Then, all requests received after the barrier request command are 
completed last. 

Unordered queuing allows the device to reorder execution of the requests 
in any way desired (as defined in the ANSI SCSI-2 specification). Unordered 
requests are not necessarily completed in the order in which they are posted by 
the class driver. 

Head of port queue requests are placed in the incoming port queue in normal 
order of occurrence. However, when the I/O is received by the device, the device 
queues the request before requests currently on the device queue. The port 
translates the queue characteristics into the appropriate SCSI-2 tag messages to 
convey the class driver's intentions on queue management. 

Non-queued I/O requests are treated as defined in the SCSI-1 specification. 
These requests represent a special barrier on the incoming port queue in that the 
port waits for all commands currently on the port queue and those in the device 
queue to complete before sending the non-queued I/O to the device. The port then 
waits for the non-queued request to complete in the device before sending any 
other I/O to the device. New I/O requests received from the class driver, while a 
non-queued request is outstanding in the device, are queued to the incoming port 
queue. 

Error recovery requests are used in error recovery. These are special requests 
that the class driver may issue while the incoming port queue is frozen. The port 
must allow these requests to pass to the device, bypassing all port driver queuing 
mechanisms. See Section 6.6 for more information about recovering queues from 
errors. 

6.4 SPI Interface for SCSI-2 Devices 

The SCSI-2 port interface (SPI) consists of a group of routines within the port 
driver that queue requests and manage the queue connection between a SCSI-2 
port driver and a SCSI-2 device. 

When a connection must be established, a SCSI-2 command transmitted, 
or any data transferred, a SCSI-2 class driver calls the appropriate routine 
within the port driver by invoking one of a series of macros, defined in 
SYS$LIBRARY:LIB.MLB. Each macro corresponds to a vector in the SCSI 
port decriptor table (SPDT) that supplies the address of the port routine that 
performs the applicable function. Table 6-1 lists the SCSI-2 SPI macros and their 
functions: 
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Table 6-1 SCSI-2 Port Interface (SPI) Macros 


Macro 

Function 

SPI$QUEUE_COMMAND 

Initiates a new I/O to the port driver for queued SCSI-2 
command tagged requests (analogous to the SPI$SEND 
COMMAND) 

SPI$RELEASE_QUEUE 

Clears the frozen state of the port queues allowing queue 
processing to resume and new I/O to be processed 


6.5 Connection Characteristics for SCSI-2 Devices 

The port driver recognizes queuing support in a particular device using the SPI 
connection characteristic set up by the class driver. If a class driver attempts 
to issue a queued command to a device not recognized as supporting command 
queuing, the port converts the queued request to a non-queued request. So that 
queuing for a particular device can easily be enabled or disabled by changing the 
connection characteristic, this request must not be treated as an error condition. 

Connection characteristics are established by the SPI$GET_CONNECTION_ 
CHAR and SPI$SET_CONNECTION_CHAR macro calls as described in the 
OpenVMS VAX Device Support Reference Manual. To support the tagged 
command queuing mechanism, characteristics are implemented in longword #12 
at the end of the get and set connection characteristic data block (buffer) of these 
macro routines. 

The SCSI-2 connection characteristics (bits 0—1) are as follows: 

SCDT$V_SCSI_2 SCSI-2 conformant device (bit 0) 

SCDT$V_CMDQ Command queuing supported by device (bit 1) 

The SCDT$V_SCSI_2 characteristic bit is set when the class driver detects 
that a device is a SCSI-2 device type. A SCSI-2 device conveys its type to the 
class driver in the standard INQUIRY data. The SCSI_2 bit is not required 
for command queuing, but is provided as an implementation convenience. Port 
drivers can use the SCSI_2 bit or may rely on the occurrence of SCSI-2 behavior 
or features to sense and perform any SCSI-2 type operations. For example, not 
all SCSI-1 or CCS level devices properly handle the ABORT message as most 
SCSI-2 devices do. 

The SCDT$V_CMDQ characteristic bit is set when the class driver detects that 
a device supports command queuing. This information is conveyed by the device 
using the CMDQ bit in the INQUIRY data. A class driver may also reset this 
characteristic at any time to disable queuing by the port driver. The port driver 
treats any queued request to a device that does not have the CMDQ characteristic 
as a non-queued request. (See Section 6.3.) If the port driver does not support 
command queuing (SPDT$M_CMDQ bit in the port capability mask), the class 
driver must not set the CMDQ characteristic. 

6.6 Recovering Queues from Errors 

The class driver must issue the appropriate MODE_SENSE/SELECT commands 
to clear the QErr bit in the SCSI Mode Parameter Page OA^e- The QErr bit 
specifies whether the device will flush its internal command queue or resume it 
after a contingent allegiance condition is cleared. Clearing the QErr bit stalls 
the commands in the device queue until the contingent allegiance is cleared. 
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Issuing MODE_SENSE/SELECT commands is a class driver function and is, 
therefore, not performed by the port as a result of SPI$SET_CONNECTION_ 
CHAR. 


_ Caution _ 

The consequences of setting QErr to 1 are unpredictable and may yield 
undesirable results. 


When a command terminates in the device with a CHECK_CONDITION SCSI 
state, the device enters a contingent allegiance condition (defined by SCSI- 
2 specification). At this point, both the device queue and the incoming port 
queue are frozen. The port driver sets the SCDT$V_QUEUE_FROZEN bit. For 
information about the SCDT data structure, see Section 6.8.2 and the OpenVMS 
VAX Device Support Reference Manual. 

The class driver issues a REQUEST_SENSE command with the ERROR_ 
RECOVERY queue characteristic specified. Here, ERROR_RECOVERY signals 
the port driver that this command should be allowed to pass to the device while 
the incoming port queue is still frozen. The port issues the ERROR_RECOVERY 
request as an untagged command. Any new I/O requests issued to the port while 
the queue is frozen, which does not have the ERROR_RECOVERY characteristic, 
are returned with failure status. 

Note that the REQUEST_SENSE command will unfreeze the device queue and 
allow the queue to continue processing commands. The incoming port queue, 
however, remains frozen until the class driver explicitly releases the queue. 

Once the class driver issues a REQUEST_SENSE command, it must call 
SPI$RELEASE_QUEUE to inform the port driver that it can continue to process 
the incoming port queue. Once the REQUEST_SENSE command is sent, the 
device continues to process commands and may complete commands to the port 
before the class driver calls SPI$RELEASE_QUEUE. This is not an error as 
SPI$RELEASE_QUEUE is provided to prevent the port from issuing a new 
command to the device before the class driver sends the REQUEST_SENSE 
command, thereby inadvertently clearing the contingent allegiance condition. 

For I/O returned while the queue is frozen, a failure status of SS$_SUSPENDED 
is returned. 

6.7 I/O Flow Through the Queues 

This section summarizes the I/O flow through the queues of a SCSI-2 class/port 
driver shown in Figure 6—1. The sequence of I/O flow follows: 

1. A $QIO starts an I/O with a SCSI-2 class/port driver. The $QIO checks the 
busy bit (UCB$M_BSY). If this bit is set, the I/O is queued to the UCB busy 
queue and the $QIO returns. If the busy bit is clear, $QIO posts the I/O to 
the STARTIO routine, which sends the I/O to the port driver. The port driver 
inserts this I/O on the incoming port queue. 

2. The port driver then removes this I/O from the incoming port queue and 
queues it to the in-device queue as it sends the I/O to the device. 

3. Later, the I/O completes in the device and is removed from the in-device 
queue and returned to the class driver. 
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4. The class driver, at this point, may be processing other I/O such as removing 
an I/O previously queued in the UCB busy queue by posting it to the 
STARTIO and port driver. The originally completed I/O continues through 
post-processing and is returned to the $QIO to be completed to the user 
process. 

If an error occurs, I/O flow proceeds as follows: 

1. I/O on the in-device queue resumes once the REQUEST_SENSE command is 
sent. 

2. I/O on the incoming port queue suspends until the class driver issues the 
SPI$RELEASE_QUEUE call. 

3. Any new I/O received before SPI$RELEASE_QUEUE is called is returned 
with a failure status. 


6.8 Data Structures for SCSI-2 Devices 

This section describes the new data structure fields that implement the SCSI-2 
command queuing interface, which affect the following data structures: 

• SCDRP — SCSI class driver request packet 

• SCDT — SCSI connection descriptor table 

• SPDT — SCSI port descriptor table 

6.8.1 SCSI Class Driver Request Packet (SCDRP) Changes 

Table 6-2 lists and describes the new fields added to the SCDRP structure. For 
information about the existing fields, see the OpenVMS VAX Device Support 
Reference Manual. 


Table 6-2 New Fields of SCSI Class Driver Request Packet (SCDRP) 
Field Name Contents 


SCDRP$W_QUEUE_TAG 

SCDRP$W_QUEUE_CHAR 


SCDRP$L_CLASS_STACK_ 

PTR 

SCDRP$L_CLASS_STACK 

SCDRP$L_PQFL 


SCSI-2 queue tag for this I/O allocated by the port driver. For more 
complex ports where the tag allocation is done by adapter firmware, this 
field is undefined. 

SCSI-2 queuing characteristic specified for this I/O. This field is filled in 
by the SPI$QUEUE_COMMAND as the class driver specifies one of the 
following values: 

0 SCDRP$K_UNORDERED 

1 SCDRP$K_HEAD 

2 SCDRP$K_ORDERED 

3 SCDRP$K_NOT_QUEUED 

4 SCDRP$K_ERROR_RECOVERY 

Class driver return address stack pointer for SCSI-2 devices only. 


Class driver return address stack for SCSI-2 devices only (replaces 
UCB$L_STACK). 

Port (incoming and in-device) queue forward link used by INSQUE and 
REMQUE. 

(continued on next page) 
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Table 6-2 (Cont.) New Fields of SCSI Class Driver Request Packet (SCDRP) 

Field Name Contents 


SCDRP$L_PQBL 

SCDRP$L_BUS_PHASE 


SCDRP$L_OLD_PHASES 

SCDRP$L_EVENTS_SEEN 


Port (incoming and in-device) queue backward link. 


Current SCSI bus phase. The SCSI port driver defines the following flags 
in this longword bit map: 


SCDRP$V_DATAOUT 

SCDRP$V_DATAIN 

SCDRP$V_CMD 

SCDRP$V_STS 

SCDRP$V_INV 1 

SCDRP$V_INV2 

SCDRP$V_MSGOUT 

SCDRP$V_MSGIN 

SCDRP$V_ARB 

SCDRP$V_SEL 

SCDRP$V_RESEL 

SCDRP$V_DISCON 

SCDRP$V_CMD_CMPL 


DATA OUT phase 

DATA IN phase 

COMMAND phase 

STATUS phase 

Invalid phase 1 

Invalid phase 2 

MESSAGE OUT phase 

MESSAGE IN phase 

ARBITRATION phase 

SELECTION phase 

RESELECTION phase 

DISCONNECT message seen 

COMMAND COMPLETE message 
received 


SCDRP$V_TMODISCON Disconnect operation timed out 

SCDRP$V_FREE BUS FREE phase 


Bus phase tracking information. 

Longword bit mask of bus events seen by the SCSI port driver. The 
following bits are defined: 

SCDRP$V_PARERR Parity error 


SCDRP$V_BSYERR 

SCDRP$V_MISPHS 

SCDRP$V_BADPHS 

SCDRP$V_RST 

SCDRP$V_CTLERR 

SCDRP$V_BUSERR 

SCDRP$V_ABORT 

SCDRP$V_MSGERR 


Bus lost during command 
Missing bus phase 
Bad phase transition 
Bus reset during command 
SCSI controller error 
SCSI bus error 
I/O has been aborted 
Error during message send 

(continued on next page) 
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Table 6-2 (Cont.) New Fields of SCSI Class Driver Request Packet (SCDRP) 


Field Name 

Contents 


SCDRP$L_CNX_STS 

Longword bit mask for the connection status. The following bits are 
defined: 


SCDRP$V ABORT 
PND 

Abort pending on connection 


SCDRP$V ABORT 
CMPL 

Abort completed on connection 


SCDRP$V ABORT 
INPROG 

Abort in progress 


SCDRP$V ABORT 
RESEL 

Port was reselected while abort was in progress 


SCDRP$V PND 

RESEL 

Reselection interrupt pending 


SCDRP$V_DSCN 

Connection is disconnected 


SCDRP$V 

TMODSCN 

Connection timed out 

SCDRP$L_SEQUENCE 

Sequence number for this I/O. 

SCDRP$W_PHASES 

Bus phase tracking information. This field is 44 bytes long. 

SCDRP$L_PHASE_STK_PTR 

Address of the top of the bus phase stack. The SCSI port driver uses the 
bus phase stack to maintain a phase histogram. 

SCDRP$L PHASE END STK 
PTR 

Address of the bottom of the bus phase stack. The SCSI port driver uses 
the bus phase stack to maintain a phase histogram. 

SCDRP$L_SCDRP_SAV2 

Saved address of original SCDRP request sense. 

SCDRP$L_ADDNL_INFO 

Information bytes from 

sense data. 

SCDRP$L_SENSE_KEY 

Request sense key from check condition. 


The SCDRP$L_SCSI_FLAGS field has the following new flag bits: 

SCDRP$V_QUEUE_FULL Indicates a full queue to port driver when the port is 

sending I/O to device. 

SCDRP$V_QUEUED_IO Indicates a queued I/O characteristic when set. 

Indicates a not-queued I/O and error recovery when 
zero. 

SCDRP$V_ERROR_REC_IO Indicates an error recovery I/O. 

As shown in Figure 6—2, the new fields are appended to the end of the SCDRP 
structure at byte offset 412. 
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Figure 6-2 SCSI Class Driver Request Packet (SCDRP) 


SCDR P$B_FLCK 


SCDRP$L_FQFL 


SCDRP$L_FQBL 


SCDRP$B_CD_TYPE 


SCDRP$L_FPC 


SCDRP$L_FR3 


SCDRP$L_FR4 


SCDRP$L_PORT_UCB 


SCDRP$L_UCB 


SCDRP$W_SCDRPSIZE 


SCDR P$W_ST S 


SCDRP$W_FUNC 


Reserved 


SCDRP$L_SVAPTE 


SCDRP$W_BOFF 


SCDRP$L_BCNT 


SCDRP$L_MEDIA 


SCDRP$L_ABCNT 


SCDRP$L_SAVD_RTN 


SCDRP$L_MSG_BUF 


SCDRP$L_RSPID 


SCDRP$L_CDT 


SCDRP$L_RWCPTR 


SCDRP$L_IRP 


SCDRP$L_SVA_USER 


SCDRP$L_CMD_BUF 


SCDRP$L_CMD_BUF_LEN 

SCDRP$L_CMD_PTR 


SCDRP$L_STS_PTR 


SCDRP$L_SCSI_FLAGS 


SCDRP$L_DATACHECK 
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(continued on next page) 
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SCDRP$L_SCS!_STK_PTR 


108 

112 

144 

148 

152 

156 

60 


SCDRP$L_SCSI_STK (32 bytes) 


SCDRP$L_CL_RETRY 


SCDRP$L_DMA_TIMEOUT 


SCDRP$L_DISCON_TIMEOUT 


Reserved 


SCDRP$W_PAD_BCNT 


SCDRP$B_TQE* (52 bytes) 


*1 


SCDRP$L_TQE_DELAY* 


212 

216 

220 

224 

228 

232 

236 

240 

244 

|248 

256 

260 

264 

268 

272 

276 

280 

284 

288 


SCDRP$L_SVA_DMA* 


SC D R P$ L_S VA_C M D* 


SCDRP$W_CMD_MAPREG* 


SCDRP$W_MAPREG* 


SCDRP$W_CMD_NUMREG* 


SCDRP$W_NUMREG* 


SCDRP$L_SVA_SPTE* 


SCDRP$L_SCSIMSGO_PTR* 


SCDRP$L_SCSIMSGI_PTR* 


SCDRP$B_SCSIMSGO_BUF* 


SCDRP$B_SCSIMSGI_BUF* 


SCDRP$L_MSGO_PENDING* 


SCDRP$L_MSGI_PENDING* 


Reserved 


SCDRP$B_LAST_MSGO 


SCDRP$L_DATA_PTR* 


SCDRP$L_TRANS_CNT* 


SCDRP$L_SAVE_DATA_CNT* 


SCDRP$L_SAVE_DATA_PTR* 


SCDRP$L_SDP_DATA_CNT* 


SCDRP$L_SDP_DATA_PTR* 


(continued on next page) 
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SCDRP$L_DUETIME* 


SCDRP$L_TIMEOUT_ADDR* 


SCDRP$W_BUSY_RETRY_CNT* 


SCDRP$W_CMD_BCNT* 


SCDRP$W_SEL_RETRY_CNT* 


SCDRP$W_ARB_RETRY_CNT* 


SCDRP$W_SEL_TQE_RETRY_CNT* 


SCDRP$W_CMD_RETRY_CNT* 


SCDRP$L_SAVER3* 


SCDRP$L_SAVER6* 

SCDRP$L_SAVER7* 


SCDRP$L_SAVER3CL* 


SCDRP$L_SAVEPCCL* 


SCDRP$L_ABORTPCCL* 


SCDR P$L_PO_STK_PTR* 
SCDRP$L_PO_STK* (24 bytes) 


SCDRP$L_TAG* 


Reserved (44 bytes) 


SCDRP$W_QUEUE_CHAR* 


SCDRP$W_QUEUE_TAG* 


SCDRP$L_CLASS_STACK_PTR* 
SCDRP$L_CLASS_STACK* (40 bytes) 


SCDRP$L_PQFL* 

SCDRP$L_PQBL* 


SCDRP$L_BUS_PHASE* 


SCDRP$L_OLD_PHASES* 

SCDRP$L_EVENTS_SEEN* 

SCDRP$L_CNX_STS* 

SCDRP$L_SEQUENCE* 


(continued on next page) 
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*A read-only field from the class driver point of view 

6.8.2 SCSI Connection Descriptor Table (SCDT) Changes 

Table 6-3 lists and describes the new fields added to the SCDT structure. For 
information about the existing fields, see the OpenVMS VAX Device Support 
Reference Manual. 

Table 6-3 New Fields of the SCSI Connection Descriptor Table (SCDT) 

Field Name Contents 

SCDT$L_PORT_QFL Forward queue header link in managing the incoming port queue. As each 

I/O is sent to the device, it is removed from the port queue and placed on the 
in-device queue (SPDT$L_DEV_QBL). 

SCDT$L_PORT_QBL Backward (tail) queue header link in managing the incoming port queue. 

SCDT$L_DEV_QFL Forward queue header link in managing the in-device queue of I/O requests 

that were sent to the device. 

SCDT$L_DEV_QBL Backward (tail) queue link in managing the in-device port queue. 

SCDT$L_QUEUE_FLAGS Port queue flags for queue management are as follows: 

SCDT$V_CMDQ Indicates this connection supports command 

queuing. 

SCDT$V_FLUSHQ Indicates this connection is to flush on error. 

SCDT$V_SCSI_2 Indicates the device conforms to SCSI-2. 

SCDT$V_QUEUE_ Indicates the port queue is currently waiting for 

WAIT a command to complete in the device. The I/O 

causing the wait is identified in the SCDT$W_ 
WAIT_TAG field. When this I/O completes, the 
SCDT$V_QUEUE_WAIT bit is cleared unblocking 
the queue. 

(continued on next page) 
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Table 6-3 (Cont.) New Fields of the SCSI Connection Descriptor Table (SCDT) 


Field Name 

Contents 



SCDT$V QUEUE 
FROZEN 

Indicates a queued command has terminated with 
a CHECK_CONDITION SCSI status. Used by 
the port driver to know when the port is waiting 
for the class driver to complete its error recovery. 
Cleared by the SPI$RELEASE_QUEUE call. Any 
I/O received while this bit is set is immediately 
returned to the class driver with failure status. 
This bit is also set by the SPI$FREEZE QUEUE 
call. 


SCDT$V FLUSHING 
QUEUE 

Indicates the port is flushing the device and 
port queues. I/O received while this bit is set 
is immediately returned to the class driver 
with failure status. Cleared by a count 0 in 
the SCDT$W_DEV_IO_COUNT and SCDT$W_ 
PORT IO COUNT fields. This bit is also set by 
the SPI$FLUSH_QUEUE call. 


SCDT$V QUEUE 

FULL 

Queue full status detected. 

SCDT$W$_TAG_MAP 

Quadword bitmap of allocated tags. A bit set in this map indicates a 
tag value in use. Tag values in the map can be from 0 to 63 allowing 64 
outstanding I/Os in a device. 

SCDT$W_DEV_IO_COUNT 

Number of I/Os currently outstanding on the in-device queue. 

SCDT$W PORT IO 

COUNT 

Number of I/Os currently outstanding on the incoming port queue. 

SCDT$W_WAIT_TAG 

Synchronizes the port queue for a non-queued I/O request. A tag value is 
still allocated though the command is not sent as a tagged command to the 
device. The port will not initiate queued I/O if the SCDT$V_QUEUE_WAIT 
bit is set until the I/O in SCDT$W_WAIT_TAG has completed. 

SCDT$W_MAX_TAG 

Largest tag value used. 


SCDT$W_MAX_QUEUE 

Class driver imposed limit. 

SCDT$L_SEQUENCE 

Next sequence to be used. 

SCDT$L NEXT 

SEQUENCE 

Next sequence ID to be sent to the device. 

SCDT$L_SCDRP_MAP 

Pointer to a list of SCDRPs indexed by the tag value. Reduces searching by 
SCDT$L_DEV_QFL. 


As shown in Figure 6—3, the new fields are appended to the end of the SCDT 
structure at byte offset 244. 

Figure 6-3 SCSI Connection Descriptor Table (SCDT) 



SCDT$L_FLINK* 

SCDT$B_SUBTYP* 

SCDT$B_TYPE* 

SCDT$W_SIZE* 

SCDT$B_FLCK* 


Reserved 


SCDT$L_FPC* 


(continued on next page) 
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SCDT$L_FR3* 


SCDT$L_FR4* 


SCDT$L_STS* 


SCDT$L_SPDT* 


SCDT$L_SCSI_PORT_ID* 


SCDT$L_SCSI_BUS_ID* 


SC DT $ W_SC DT_TY PE* 



SCDT$L_SCSI_LUN* 


SCDT$L_AUXSTRUC 


SCDT$L_SCDTLST 


SCDT$L_SCDRP_ADDR* 


SCDT$L_BUS_PHASE* 


SCDT$L_OLD_PHASES* 


SCDT$W_PHASES* (44 bytes) 


SCDT$L_PHASE_STK_PTR* 


SCDT$L_PHASE_END_STK_PTR* 


SCDT$L_EVENTS_SEEN* 


SCDT$L_ARB_FAIL_CNT* 


SCDT$L_SEL_FAIL_CNT* 


SCDT$L_PARERR_CNT* 


SCDT$L_MISPHS_CNT* 


SCDT$L_BADPHS_CNT* 


SCDT$L_RETRY_CNT* 


SCDT$L_RST_CNT* 


SCDT$L_CTLERR_CNT* 


SCDT$L_BUSERR_CNT* 


SCDT$L_CMDSENT* 


SCDT$L_MSGSENT* 
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SCDT$L_BYTSENT* 


SCDT$L_CON_FLAGS* 


SCDT$L_SYNCHRONOUS* 


SCDT$W_TRANSFER_PERIOD* 


SCDT$W_REQACK_OFFSET* 


SCDT$W_ARB_RETRY_CNT* 


SCDT$W_BUSY_RETRY_CNT* 


SCDT$W_CMD_RETRY_CNT* 


SCDT$W_SEL_RETRY_CNT* 


SCDT$L_DMA_TIMEOUT* 


SCDT$L_DISCON_TIMEOUT* 

SCDT$L_SEL_CALLBACK* 


SCDT$L_SEL_CONTEXT* 


Reserved (36 bytes) 


SCDT$L_PORT_QFL* 

SCDT$L_PORT_QBL* 

SCDT$L_DEV_QFL* 

SCDT$L_DEV_QBL* 


SCDT$L_QUEUE_FLAGS* 


SCDT$Q_TAG_MAP* 


SCDT$W_PORT_IO_COUNT* 


SCDT$W_DEV_IO_COUNT* 


SCDT$W_MAX_TAG_USED* 


SC DT$W_WAIT_TAG * 


Reserved 


SCDT$W_MAX_QUEUE_DEPTH* 


SCDT$L_SEQUENCE* 


SCDT$L_NEXT_SEQUENCE* 


SCDT$L_SCDRP_MAP* 


*A read-only field from a class driver point of view 
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6.8.3 SCSI Port Descriptor Table (SPDT) Changes 

Table 6—4 lists and describes the new fields added to the SPDT structure. For 
information about the existing fields, see the OpenVMS VAX Device Support 
Reference Manual. 


Table 6-4 New Fields of the SCSI Port Descriptor Table (SPDT) 

Field Name Contents 


SPDT$L_QUEUE_CMD 

SPDT$L_FREEZE_QUEUE 
SPDT$L_RELEASE_QUEUE 
SPDT$L_FLU SH_QUEUE 

SPDT$L_TVDRV_ISR 

SPDT$L_TVDRV_DMA_ 

BASE 

SPDT$L_TVDRV_DMA_SIZE 

SPDT$L_TVDRV_UCB 

SPDT$L_CUR_SCDT_VEC 

SPDT$L_QMAN_RE SUME 

SPDT$L_OWNER_TAG 

SPDT$L_PORT_IO_COUNT 

SPDT$L_QUEUE_SPINS 

SPDT$L_QUEUE_EXITS 


Address of the port driver routine that executes in response to a class 
driver’s SPI$QUEUE_COMMAND call. The port driver initializes this 
field. 

Address of the port driver routine that executes in response to a class 
driver’s SPI$FREEZE_QUEUE call. The port driver initializes this field. 

Address of the port driver routine that executes in response to a class 
driver’s SPI$RELEASE_QUEUE call. The port driver initializes this field. 

Address of the port driver routine that executes in response to a class 
driver’s SPI$FLUSH_QUEUE call. The port driver initializes this field. 

Address of the TVDriver’s ISR. 

Address of the TVDriver’s DMA buffer. 


Size of the TVDriver’s DMA buffer. 

Address of the TVDriver’s UCB. 

Pointer into SCDTVECTOR for CMDQ. 
Address to resume QUEUE_MANAGER. 

Tag value of bus owner thread. 

I/O number in port using SEND/QUEUE_CMD. 
Number of passes over port queues. 

Number of exits from the queue manager. 


The following new flag bits are added to the SPDT$L_STS field: 

SPDT$V_QUEUE_PROC Indicates the port queue manager is running. 

SPDT$V_QWORK_DONE Indicates the port queue manager has completed work 

in the current pass over the SCDT vector table. 

SPDT$V_RESET_ISSUED Indicates port driver reset the SCSI bus. 

The following new flag bit is added to the SPDT$L_PORT_FLAGS field (port 
capability mask): 

SPDT$V_CMDQ Indicates the port supports command queuing I/O. 

As shown in Figure 6-4, four new fields are inserted at byte offset 500 and 10 
new fields are appended to the end of the structure at byte offset 704. 
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Figure 6-4 SCSI Port Descriptor Table (SPDT) 


SPDT$L_FLINK* 
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148 

152 


SPDT$B_SUBTYP* 


SPDT$B_TYPE* 


SPDT$W_SIZE* 


SPDT$B_FLCK* 


SPDT$B_SCSI_INT_MSK 1 


S P DT $ W_S P DT_T Y PE* 


SPDT$L_FPC* 


SPDT$L_FR3* 


SPDT$L_FR4* 


SPDT$L_SCSI_PORT_ID* 


SPDT$L_SCSI_BUS_ID* 


SPDT$L_STS* 


SPDT$L_PORT_WQFL* 


SPDT$L_PORT_WQBL* 


SPDT$L_MAXBYTECNT* 


SPDT$L_WAITQFL 


SPDT$L_WAITQBL 


SPDT$L_PORT_UCB* 


SPDT$L_PORT_CSR* 


SPDT$L_PORT_IDB* 


SPDT$L_DMA_BASE* 


SPDT$L_SPTE_BASE* 


SPDT$L_SPTE_SVAPTE* 


SPDT$L_ADP* 


SPDT$L_PORT_RING* (64 bytes) 


SPDT$L_PORT_RING_PTR* 


SPDT$L_OWNERSCDT* 


SPDT$L_SCDT_VECTOR* (256 bytes) 


#156 


(continued on next page) 
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SPDT$L_DLCK* 


412 

416 

420 

424 

428 

432 

436 

440 

444 

448 

452 

456 

460 

464 

468 

472 

476 

480 

484 

488 

492 

496 

500 

504 

508 

512 


Reserved 


SPDT$B_DIPL* 


SPDT$L_AUXSTRUC 


SPDT$L_SEL_SCDRP* 


SPDT$L_ENB_SEL_SCDRP* 


SPDT$L_MAP_BUFFER* 


SPDT$L_UNMAP* 


SPDT$L_SEND* 


SPDT$L_SET_CONN_CHAR* 


SPDT$L_GET_CONN_CHAR* 


SPDT$L_RESET* 


SPDT$L_CONNECT* 


SPDT$L_DISCONNECT* 


SPDT$L_ALLOC_COMMAND_BUFFER* 


SPDT$L_DEALLOC_COMMAND_BUFFER* 


SPDT$L_ABORT* 


SPDT$L_SET_PHASE* 


SPDT$L_SENSE_PHASE* 


SPDT$L_SEND_BYTES* 


SPDT$L_RECEIVE_BYTES* 


SPDT$L_FINISH_CMD* 


SPDT$L_RELEASE_BUS* 


SPDT$L_QUEUE_CMD* 


SPDT$L_FREEZE_QUEUE* 


SPDT$L_RELEASE_QUEUE* 


SPDT$L_FLUSH_QU EU E* 


Reserved (52 bytes) 


5616 


Reserved 


BUS_HUNG_VEC* 568 


(continued on next page) 
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SPDT$B_TQE* (52 bytes) 


%72 


SPDT$L_TQE_DELAY* 


624 

628 

632 

636 

640 

644 

648 

652 

656 

660 


SPDT$L_BUS_HUNG_CNT* 


SPDT$L_TARRST_CNT* 


SPDT$L_RETRY_CNT* 


SPDT$L_STRAY_INT_CNT* 


SPDT$L_UNEXPJNT_CNT* 


SPDT$L_NODISCON_CNT* 


SPDT$W_DISCON_CNT* 


Reserved 


SPDT$L_PORT_FLAGS* 


SPDT$L_VERSION_CHECK* 


Reserved (36 bytes) 


^664 


SPDT$B_EVENT_CNT* 


SPDT$B_MODE* 


SPDT$B_STATUS* 


SPDT$B_CUR_STAT* 


700 

704 

708 

712 

716 

720 

724 

728 

732 

736 

740 


SPDT$L_TVDRV_ISR* 


SPDT$L_TVDRV_DMA_BASE* 


SPDT$L_TVDRV_DMA_SIZE* 


SPDT$L_TVDRV_UCB* 


SPDT$L_CUR_SCDT_VEC* 


SPDT$L_QMAN_RESUME* 


SPDT$W_Reserved 


S P DT $ W_0 W N E R_TAG * 


SPDT$L_PORT_IO_COUNT* 


SPDT$L_QUEUE_SPINS* 


SPDT$L_QUEUE_EXITS* 


*A read-only field from a class driver point of view 
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6.9 Macros for SCSI-2 Devices 

This section describes new macros and changes that support the SCSI-2 command 
queuing interface. The following new macros specifically support SCSI-2 driver 
programs: 

• SPI$QUEUE_COMMAND 

• SPI$RELEASE_QUEUE 

The following existing macros contain changes to support SCSI-2 driver programs: 

• SPI$CONNECT 

• SPI$GET_CONNECTION_CHAR 

• SPI$SET_CONNECTION_CHAR 


6.9.1 SPI$CONNECT for SCSI-2 Support 

The existing SPI$CONNECT macro now supports SCSI-2 devices. A new port 
capability mask bit (SPDT$M_CMDQ) of the SPDT$L_PORT_FLAGS is returned 
in R3. SPDT$M_CMDQ is set when the driver supports command queuing I/O. 

The address of the SPDT structure must be supplied in R4 as an input before the 
SPI$CONNECT call. 

For more information about the connection and connection characteristics macro, 
see the OpenVMS VAX Device Support Reference Manual. 


6.9.2 SPI$GET_CONNECTION_CHAR and SPI$SET_CONNECTION_CHAR for 
SCSI-2 Support 

The existing SPI$GET_CONNECTION_CHAR and SPI$SET_CONNECTION_ 
CHAR macros now support SCSI-2 device connections. Appended to the macro 
characteristic buffer of longwords for these macros is a new longword (#12) that 
contains SCSI-2 characteristic status bits (0-1) as follows: 


SCDT$V_SCSI_2 
SCDT$V_CMDQ 
Bits 2-31 


SCSI-2 conformant device (bit 0). 

Command queuing supported by device (bit 1). 
Reserved. 
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SPI$QUEUE_COMMAND 

Initiates a new I/O to the port driver for queued SCSI-2 command tagged 
requests. 


Format 

SPI$QUEUE_COMMAND 


Description 

The SPI$QUEUE_COMMAND initiates a new I/O to the port driver for queued 
SCSI-2 command tagged requests. This macro is similar to the SPI$SEND_ 
COMMAND, but SPI$QUEUE_COMMAND does not wait for command 
completion in the device before returning to the class driver. 

A class driver first calls SPI$ALLOCATE_COMMAND_BUFFER to allocate a port 
command buffer and then formats a SCSI command descriptor block in this buffer 
before invoking this macro. The class driver may need to call SPI$MAP_BUFFER 
to allocate and map user buffer resources. To execute a burst of I/O requests, 
the class driver may also call SPI$QUEUE_COMMAND for each request without 
waiting for any of these I/O requests to complete. When an I/O request completes, 
the port driver then returns SCSI status to the class driver. 

Table 6-5 lists the inputs to the SPI$QUEUE_COMMAND macro. 


Table 6-5 Inputs to the SPI$QUEUE_COMMAND Macro 
Location Contents 


RO 

R3 

R4 

R5 


Queue characteristics (constants, QCHAR$K_jcjcx). 
Address of the UCB. 

Address of the SPDT. 


Address of the SCDRP. The class driver must provide values 
in the following fields: 


SCDRP$L_CMD_PTR 


SCDRP$L_BCNT 
S C DRP$ W_PAD_B C NT 


Address of the port command 
buffer. The first longword of the 
port command buffer contains the 
number of bytes in the buffer (not 
including the count longword). 
Subsequent bytes contain the 
SCSI command descriptor block. 

Size in bytes of the mapped 
process buffer. 

Number of bytes to make the 
size of the buffer equal to the 
data length value required in the 
command. 


(continued on next page) 
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Table 6-5 (Cont.) Inputs to the SPI$QUEUE_COMMAND Macro 


Location 

Contents 



SCDRP$L_SVA_USER 

System virtual address of the 
process buffer as mapped in 
system space (SO space). 


SCDRP$L_STS_PTR 

Address of the status longword. 

The port driver copies the SCSI 
status byte it receives in the bus 
STATUS phase into the low-order 
byte of this buffer. 


SCDRP$W_FUNC 

Read or write operation. 


SCDRP$L_CDT 

Address of the SCDT. 

The port driver returns the values listed 
preserving R3, R4, and R5. 

in Table 6—6 to the class driver, 

Table 6-6 

SPI$QUEUE_COMMAND Macro Return Values 

Location 

Contents 


RO 

Port status. The port driver returns one of the following status 


values: 

SS$_BADPARAM 

Bad parameter specified by the class 
driver. 


SS$_CTRLERR 

Controller error or port hardware 
failure. 


SS$_DEVACTIVE 

Command outstanding on this 
connection. 


SS$_DEVREQERR 

SCSI message reject. 


SS$_IVSTSFLG 

All required phases are not entered. 


SS$_LINKABORT 

Connection no longer exists. 


SS$_NORMAL 

Normal, successful completion. 


SS$_TIMEOUT 

Failed during selection or arbitration. 


SS$_PARITY 

Non-recoverable parity error detected. 

R5 

Address of the SCDRP. The port driver provides information in 


the following fields: 
SCDRP$L_STS_PTR 

Address of the status longword. The 
port driver copies the SCSI status 
byte it receives in the bus STATUS 
phase into the low-order byte of this 
buffer. 


SCDRP$L_TRAN S_ 

Actual number of bytes sent or 


CNT 

received by the port driver during 
the Data phase. 
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SPI$RELEASE_QUEUE 


Clears the frozen state of the SCSI-2 port driver queues. 


Format 


SPI$RELEASE_QUEUE 


Description 

The SPI$RELEASE_QUEUE macro clears the frozen state of the port driver 
queues allowing queue processing to resume and new I/O to be processed. 

The entry point routine in the port driver clears the SCDT$V_QUEUE_FROZEN 
bit in the SCDT$L_QUEUE_FLAGS longword mask. This bit is checked by the 
queue manager to signal when to resume queue processing. 

Inputs to the SPI$RELEASE_QUEUE macro include the following: 


Location 

Contents 

R3 

Address of the UCB 

R4 

Address of the SPDT 

R5 

Address of the SCDRP 


The port driver returns SS$_NORMAL status in RO and preserves the contents of 
R3, R4, and R5. 
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This release includes new messages for the following OpenVMS facilities: 

• ANALDISK, Analyze/Disk_Structure Utility 

• BACKUP, Backup Utility 

• CLI, Command Language Interpreter (DCL) 

• DDTM, DECdtm Services 

• LIB, Library Facility 

• LINK, Linker Utility 

• LMCP, Log Manager Control Program 

• LICENSE, License Management Utility 

• MAIL, Mail Utility 

• MOUNT, Mount Utility 

• MSGHLP, Help Message utility 

• PCSI, POLYCENTER Software Installation Utility 

• PCSIUI, POLYCENTER Software Installation Utility 

• PRINT, PRINT Command 

• PSM, Print Symbiont Modification Facility 

• RMS, OpenVMS Record Management Services 

• SHOW, SHOW Command 

• SUBMIT, SUBMIT Command 

• SYSBOOT, System Bootstrap Facility 

• SYSTEM, System Services 

• UAF, Authorize Utility 

This appendix alphabetically lists and describes all messages that have been 
added for this release. You can access online descriptions of these and all other 
OpenVMS system messages by using the online Help Message utility. For 
information about the HELP/MESSAGE command and qualifiers, see DCL help 
or refer to the OpenVMS System Messages: Companion Guide for Help Message 
Users. New Help Message features for this release are described in Section 2.5. 
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ABORT, fatal error encountered - operation terminated 

Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: An unrecoverable error occurred. 

User Action: Query the product database to determine the cause of the 
error. Correct the problem and retry the operation. 

ALRDYINST, product already installed; use RECONFIGURE to modify 
Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: This product is referred to by another product in the current 
installation. The product will not be reinstalled. 

User Action: None. If you want to modify the product, you must use the 
RECONFIGURE command. 

APPLYTOERR, product 'product-name' to which maintenance product 
' product-name' applies not found 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: You attempted to patch or apply a mandatory update to a 
product that cannot be found on the system. 

User Action: Verify that you have the correct mandatory update or patch kit 
and that the product you want to update is on the system. 

ASKABORT, Terminating is strongly recommended. Do you want to terminate? 
[YES] 

Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: A severe error was detected by the POLYCENTER Software 
Installation utility during the operation. Continuing might leave the system 
in an incomplete state, for example, with partially installed software. 
Terminating leaves the product database in the state it was in before this 
operation was attempted. 

User Action: Terminate the operation and identify the problem before 
reattempting the operation. An accompanying error message provides more 
information about the problem. 

BADREASON, abort reason code was invalid 
Facility: SYSTEM, System Services 

Explanation: The abort reason code passed in the reason argument of the 
$ABORT_TRANS service is invalid. 

User Action: Use a valid abort reason code. 

Block Size - Total: 'number' Optional: 'number' Required: 'number' 

Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: This message reports the total disk block consumption of a 
product or a product option. 

User Action: None, unless total disk block consumption of the product 
exceeds the space available on the destination device. In this case, stop the 
operation and create enough disk space on the destination device. 
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CANCELJWIP, termination resulted in an incomplete modification to the system 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: You interrupted an operation that was executing, leaving the 
system in an incomplete state. For example, if you interrupt an installation 
in progress, the utility does not remove any files created by the installation. 

User Action: Digital recommends that you do not interrupt POLYCENTER 
Software Installation utility operations. 

CBSNOTSUPTD, Attention - Phase I Shadowing is not supported as of 
OpenVMS VAX V6.1 

Facility: MOUNT, Mount Utility 

Facility: SYSBOOT, System Bootstrap Facility 

Explanation: You specified a phase I volume shadowing virtual unit 
(DUStttt) in a command. OpenVMS VAX no longer supports phase I volume 
shadowing. 

User Action: Reissue the command using a phase II volume shadowing 
virtual unit name (DSAnn) consistent with phase II (host-based) volume 
shadowing. 

COMPWERR, operation completed after explicit continuation from errors 
Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: If you answer No to the ASKABORT query after a severe error 
occurs, this message displays when the operation completes. 

User Action: Query the product database (PDB) to determine the cause of 
the error. Correct the problem and retry the operation. 

CONFIG, product has already been configured 

Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: This product has already been configured during this 
operation, either because it was selected or because it was included due to a 
dependency of another product. 

User Action: None. 

CONREMHV, confirm removal of higher version of ' product-name' 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: This message asks you to confirm whether to remove the 
higher version of the specified product. 

User Action: Enter Yes to remove the higher version of the product. Enter 
No to keep the higher version and to omit the lower version on the system. 

CONREMOS, confirm removal of operating system ' product-name' 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: This message displays with a question about whether to 
remove the specified operating system. 

User Action: Confirm that you want to remove the operating system or else 
exit the operation. 
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CONREMUNR, optionally remove product 'product-name' that is no longer 
required by another product 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: A software product that you are removing depends on another 
software product. This message asks if you want to remove the dependent 
software product. 

User Action: Enter Yes to remove the specified product. Enter No or press 
Return to keep the product. 

COPYREQD, destination specification required for this operation 
Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: No destination directory was specified. 

User Action: Use the /DESTINATION qualifier on the COPY command to 
specify a destination directory for the copy of the product kit. 

CURTIDCHANGE, default transaction currently being changed 
Facility: SYSTEM, System Services 

Explanation: An attempt was made to change the default transaction while 
a change is already in progress. 

User Action: Retry the transaction. 

DBINUSE, product database in use; waiting... 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: Another user is accessing the product database (PDB). 

User Action: None. The utility processes your request when the current 
user is finished using the PDB. 

DEFER, that item has been deferred. Please set the default value 
Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: No value is assigned to this configuration choice in the input 
configuration file. 

User Action: Supply a default value. This default configuration choice will 
be presented to the user during installation. 

DELETED, ' compress-file-name.TMP' deleted 
Facility: MAIL, Mail Utility 

Explanation: This informational message marks the successful deletion of a 
temporary file created by MAIL during a COMPRESS operation. 

User Action: None. 

Do you want all the defaults for the subitems? 

Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: This question prompts you to select the default values or view 
the configuration choices. 

User Action: Enter Yes or No: 

Yes Automatically selects all of the defaults established by either the product 

or the product database. You will not see any configuration choices nested 
inside this configuration choice. 
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No Displays the configuration choices that you can select. 

DUPPROD, duplicate product ignored 

Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: The product has already been selected for the operation. 

User Action: None. 

ERRNOAPPLY, APPLY TO statement is required for this distribution type 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: You are using a mandatory update or patch distribution kit 
that does not contain an apply to statement. 

User Action: Add an apply to statement to the kit. A mandatory update or 
patch kit must name the product to which the patch or update applies. 

ERRPDFPRD, product description file name does not match PRODUCT 
statement 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: The file name of the product description file (PDF) does not 
match the information contained in the product statement. 

User Action: Make sure the file name of the PDF and the product statement 
contain the same information. 

EXEFAIL, execute statement failed; status returned from DCL follows 
Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: An execute statement failed. 

User Action: Take action based on the accompanying message. 

FAILCONF, failed to resolve conflicting requirements for 'object-type' 'object- 
name' 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: More than one product supplies a managed object of the 
same name, type, and scope. They cannot coexist because of a conflict in the 
objects’ properties. 

User Action: Determine which product’s managed object you want to 
preserve and make the necessary adjustments to the system. 

FAILCONFNNM, failed to resolve conflicting requirements for 'object-type' 
(unnamed) 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: More than one product supplies a managed object of the 
same name, type, and scope. They cannot coexist because of a conflict in the 
objects’ properties. 

User Action: Determine which product’s managed object you want to 
preserve and make the necessary adjustments to the system. 

FORCED, product 'product-name' implicitly selected 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: The named product has been implicitly selected to execute in 
the current operation. 

User Action: None. 
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FORCEDDES, product 'product-name' implicitly deselected 
Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: The named product has been implicitly deselected so that it 
will not execute in the current operation. 

User Action: None. 

FORCEDRCF, product ' product-name' implicitly selected for reconfiguration 
Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: The named product has been implicitly selected to be 
reconfigured in the current operation. 

User Action: None. 

FORCEDUPG, product ' product-name' implicitly removed 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: The named product has been implicitly selected to be removed 
in the current operation. 

User Action: None. 

Global Pages - Total: 'number' Optional: 'number' Required: 'number' 
Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: This message reports the global page consumption of a product 
or a product option. 

User Action: None, unless global page consumption of the product exceeds a 
limit set by a system or process parameter. In this case, modify the system or 
process parameters accordingly. 

Global Sections - Total: 'number' Optional: 'number' Required: 'number' 
Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: This message reports the global section consumption of a 
product or product option. 

User Action: None, unless global section consumption of the product exceeds 
a limit set by a system or process parameter. In this case, modify the system 
or process parameters accordingly. 

IDXSEARCH, key search encountered index structure inconsistency - convert 
file 

Facility: RMS, OpenVMS Record Management Services 

Explanation: The last keyed access to the file exceeded a maximum 
iteration count for restarting the operation at the root index bucket for 
the key of reference. This condition can occur if the index structure has 
become inconsistent. The status value (STV) of the RAB contains the key of 
reference. 

User Action: Convert the file and retry the operation. If the error persists, 
contact a Digital service representative. 
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INTEGRITY, transaction aborted because a resource manager integrity 
constraint check failed 

Facility: DDTM, DECdtm Services 

Explanation: Either you entered invalid data, or the resource manager 
integrity constraint check was not properly defined. 

User Action: Verify your data, then retry the transaction. 

INVALKEY, that key is not valid 

Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: The answer or key you entered is not a valid reply to the 
question being asked. 

User Action: Try another response. 

INVALRESP, invalid response 

Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: Your response to the prompt is invalid. 

User Action: Specify the number that is displayed to the left of the product 
you want to select. 

INVAPLTO, multiple APPLY TO statements 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: The product description file (PDF) contains more than one 
apply to statement. 

User Action: Use only one apply to statement in the PDF. 

INVNOD, invalid node name specification; respecify 

Facility: CLI, Command Language Interpreter (DCL) 

Explanation: The node name specification is invalid. 

User Action: Reenter the command using a valid node name specification. 

INVPDFTYPE, APPLY TO statement requires distribution type of PATCH or 
MANDATORY UPDATE 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: An apply to statement occurs in a product description file 
(PDF) that is not a patch or mandatory update. 

User Action: Either remove the apply to statement or change the product 
distribution kit type in the product statement to patch or mandatory update. 

INVREMDST, remote destination must be mounted privately by the process 
performing the operation 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: The POLYCENTER Software Installation utility tried to 
place material on a volume whose owner is not the same as the owner of the 
process. 

User Action: Have the process owner privately mount the destination 
volume. 
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INVUPGRADE, multiple UPGRADE statements 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: The product description file (PDF) contains more than one 
upgrade statement. 

User Action: Use only one upgrade statement in the PDF. 

'number' items found 

Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: This message reports the number of matches found in the 
product database in response to a PRODUCT SHOW command. 

User Action: None. 

IVNODNAM, invalid node name 

Facility: SYSTEM, System Services 

Explanation: DECnet for OpenVMS has detected an invalid syntax in a 
node name specification; for example, the user attempted to specify a full 
name on a system running Phase IV DECnet. 

User Action: Retry the command using a valid node name specification. 

LASTIPCF, multiple input configuration files were specified: values in a later 
one may supersede those in a previous one 

Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: This message displays whenever you specify a list of files with 
the /CONFIGURATION=INPUT qualifier to the PRODUCT command. The 
POLYCENTER Software Installation utility does not check whether a product 
configuration choice appears in any or several of the specified configuration 
files. 

User Action: None required. You can inspect the configuration files to 
determine which products’ values are contained in each. 

LATSYM, LAT protocol requested on device ' device-name' which is not a LAT 
device 

Facility: PSM, Print Symbiont Modification Facility 

Explanation: This device is not a LAT device, but LAT symbiont protocol is 
being requested by the requested processor symbiont. 

User Action: Either use a non-LAT symbiont for this device or choose a LAT 
device for this processor. 

LOG_BUSY, transaction log busy 

Facility: LMCP, Log Manager Control Program 

Explanation: The dump aborted because the transaction log was too busy. 
This can happen when the transaction rate is very high. 

User Action: Wait until the system is less busy, then try again. 

LOG_FAIL, transaction aborted because an attempt to write to the transaction 
log failed 

Facility: DDTM, DECdtm Services 

Explanation: The DECdtm transaction log could not be written to. 

User Action: Check whether the transaction log’s disk is mounted. Use the 
Analyze/Disk_Structure utility to check for disk errors. 
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LOG_NOT_IN_USE, transaction log not in use 
Facility: LMCP, Log Manager Control Program 

Explanation: The transaction log is not in use and the TP_SERVER process 
is not running. 

User Action: None. 

MULOBJ, the 'object-type' 'object-name' is multiply defined; conflict resolution 
may occur 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: More than one managed object of the same name and type 
was detected. 

User Action: None. The POLYCENTER Software Installation utility 
attempts to resolve the conflict. 

MULOBJNNM, the 'object-type' (unnamed) is multiply defined; conflict 
resolution may occur 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: More than one managed object of the same name and type 
was detected. 

User Action: None. The POLYCENTER Software Installation utility 
attempts to resolve the conflict. 

NAFADDERR, error adding proxy from 'node-name'::'remote-user' to 'local- 
user' 

Facility: UAF, Authorize Utility 

Explanation: An error occurred while adding a network proxy for the 
remote node and user to the specified local user. 

User Action: Take action based on the accompanying message. 

NAFADDMSG, proxy from 'node-name'::'remote-user' to 'local-user' added 
Facility: UAF, Authorize Utility 

Explanation: A network proxy from the remote node and user to the 
specified local user has been added to the proxy database. 

User Action: None. 

NAFCREERR, unable to create network proxy database (NET$PROXY.DAT) 
Facility: UAF, Authorize Utility 

Explanation: A network user authorization file (NET$PROXY.DAT) could 
not be created. For example, this error occurs if you do not have sufficient 
privilege to create the file. 

User Action: Take action based on the accompanying message. 

NAFMODERR, error modifying proxy from 'node-name'::'remote-user' to 
'local-user' 

Facility: UAF, Authorize Utility 

Explanation: An error occurred while modifying a network proxy for the 
remote node and user to the specified local user. 

User Action: Take action based on the accompanying message. 
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NAFMODMSG, proxy from 'node-name'::'remote-user' to 'local-user' modified 
Facility: UAF, Authorize Utility 

Explanation: The network proxy from the remote node and user to the 
specified local user has been modified in the proxy database as requested. 

User Action: None. 

NAFREMERR, error removing proxy from 'node-name'::'remote-user' to 
' local-user' 

Facility: UAF, Authorize Utility 

Explanation: An error occurred while removing a network proxy for the 
remote node and user to the specified local user. 

User Action: Take action based on the accompanying message. 

NAFREMMSG, proxy from 'node-name':: 'remote-user' to 'local-user' removed 
Facility: UAF, Authorize Utility 

Explanation: The network proxy from the remote node and user to the 
specified local user has been removed from the proxy database. 

User Action: None. 

NAFUAEERR, proxy from 'remote-node-name::user-name' to 'local-user-name' 
already exists 

Facility: UAF, Authorize Utility 

Explanation: The local user that you tried to add to the specified remote 
network user proxy entry is already in the file; it has not been duplicated. 

User Action: None. 

NETBTS, network buffer too small for ' size' byte record 
Facility: RMS, OpenVMS Record Management Services 

Explanation: The network buffer is too small for an attempted $GET, $PUT, 
or $UPDATE operation on a remote file. For a $GET, no record is returned to 
the user’s record buffer; however, the next record pointer is properly advanced 
to the next record in the remote file, if there is one, or to the end-of-file. The 
status value (STV) in the RAB contains the size of the record that is too large 
for the network buffer. 

User Action: Increase the size of the network buffer to accommodate the 
maximum record size in the remote file. The default system setting for the 
SYSGEN RMS_DFNBC (network block count) parameter is 8, which becomes 
the process default if it is not overridden by the process. 

Determine the size of the largest record in the file either by using the DCL 
command DIRECTORY/FULL or ANALYZE/RMS_FILE or, from within the 
program, by examining the contents of the XABFHC field XAB$W_LRL after 
opening the file with the XABFHC chained to the FAB. 

Increase the network buffer size for the process by executing the DCL 
command SET RMS_DEFAULT/NETWORK_BLOCK_COUNT=n on the 
local node or, from within the program, by setting the XABITM item 
XAB$_NET_BLOCK_COUNT to ’n’ when opening the file with the XABITM 
chained to the FAB. Determine the value of’n’ as follows: 

• For a remote file opened from an image: 
n = maximum record size in blocks 
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Example: For a maximum record size of 4112 bytes, n = 9. 

4112 divided by 512 = 8.03 

• For a remote file opened using the DCL command OPEN, the actual size 
of the network buffer is derived by dividing the NETWORK_BLOCK_ 
COUNT by 8. To compensate for this, the block size must be multiplied 
by 8: 

n = (maximum record size in blocks) x 8 

Example: For a maximum record size of 2048 bytes, n = 32. 

2048 divided by 512 = 4 x 8 = 32 

NODEFER, defer key is not available at this time 

Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: No value was specified for the configuration choice default. 
User Action: Enter a configuration choice value to complete the operation. 

NODTOOLNG, primary node name too long after being quoted 
Facility: LIB, Library Facility 

Explanation: When quotation marks are added to the primary node name, 
it exceeds 1024 characters, the maximum size allowed for a node name. 

User Action: Check the primary node name argument for the call to the 
run-time library and correct the program to use a node name that does not 
exceed 1022 characters. 

NOHELP, there is no help available at this time 

Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: The Help key is not supported on this input device. Help is 
not available for individual items. 

User Action: To access help information for this product, reenter the 
PRODUCT command with the /HELP qualifier. 

NOHOSNAM, no host node name found 
Facility: LIB, Library Facility 

Explanation: The run-time library cannot get the host node name from the 
system. 

User Action: Check with your system manager to see if DECnet is running. 

NOITEMS, there are no items to answer for this product 

Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: The product has no configuration choices. 

User Action: None. 

NOLIBRARIES, none of the specified libraries were found; check logical name 
MSGHLP$LIBRARY 

Facility: MSGHLP, Help Message utility 

Explanation: The search path logical name MSGHLP$LIBRARY is defined 
to point to a number of database files, none of which exists. 

User Action: Verify that the logical name search path defines 
existing Help Message database files, or deassign the logical 
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name so that Help Message accesses the default database file, 
SYS$HELP:MSGHLP$LIBRARY.MSGHLP$DATA. 

NOMATCH, no products found matching: 

Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: No products were found to satisfy the selected product filter or 
search criteria for the chosen operation. 

User Action: None required. However, you can change the filters as desired 
to control product selection. 

The /SOURCE qualifier (which defaults to the logical name PCSI$SOURCE) 
determines the source search path used to find products for operations that 
require kits. The POLYCENTER Software Installation utility searches the 
product database for other operations. The product name parameter and the 
/PRODUCER, /BASE_SYSTEM, and /VERSION qualifiers operate as product 
filters. 

NOPRIV, insufficient privilege to display complete information 
Facility: SHOW, SHOW Command 

Explanation: You do not have sufficient privilege to see all the users of an 
Activity license. 

User Action: See your system manager. You must obtain GROUP privilege 
to see license users in the same group and WORLD privilege to see license 
users outside your group. 

NOPROD, no products found on which to perform this operation 
Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: No products were found to satisfy the selected product filter or 
search criteria for the chosen operation. 

User Action: None required. However, you can change the filters as desired 
to control product selection. 

The /SOURCE qualifier (which defaults to the logical name PCSI$SOURCE) 
determines the source search path used to find products for operations that 
require kits. The POLYCENTER Software Installation utility searches the 
product database for other operations. The product name parameter and the 
/PRODUCER, /BASE_SYSTEM, and /VERSION qualifiers operate as product 
filters. 

NOTORIGIN, process did not start the transaction 
Facility: SYSTEM, System Services 

Explanation: The process calling $END_TRANS is not the same process 
that called $START_TRANS. 

User Action: Check your application to ensure that $START_TRANS and 
$END_TRANS are called by the same process, then retry the transaction. 

NOTTRANS, INFER statement requires distribution type of TRANSITION 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: You are using an infer statement in a product description file 
(PDF) that is not a transition kit. 

User Action: Either remove the infer statement or change the product 
statement to the transition type. 
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NOUNSHELVE, file 'file-name' is shelved, this process does not automatically 
unshelve files 

Facility: PRINT, PRINT Command 
Facility: SUBMIT, SUBMIT Command 

Explanation: Your process tried to access a shelved file, and automatic 
unshelving is turned off. 

User Action: Do one of the following: 

• Use the DCL command SET PROCESS/AUTO_UNSHELVE to turn 
automatic unshelving on. 

• Use the DCL command UNSHELVE to unshelve the shelved file. 

NO WRITE, no write key is not available at this time 

Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: No configuration choice value was specified. 

User Action: Specify a value for the configuration choice in order to complete 
the operation. 

OBJDES, the 'object-type' 'object-name' is part of an option that was not 
selected - replacement skipped 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: The named managed object will not execute in this operation. 
User Action: None. 

ONFADDERR, error adding entry to old format proxy database 
(NETPROXY.DAT) 

Facility: UAF, Authorize Utility 

Explanation: An error occurred while adding a proxy record to the old 
format proxy database. 

User Action: Take action based on the accompanying message. 

ONFBUFOVF, old format proxy database record exceeds maximum length 
(NETPROXY.DAT) 

Facility: UAF, Authorize Utility 

Explanation: A record in the old format proxy database has an invalid 
record length. This error can occur if the old proxy database is damaged. 

User Action: Restore the old format proxy database from a backup copy and 
reenter the command. 

ONFCONERR, connect error on old format proxy database (NETPROXY.DAT) 
Facility: UAF, Authorize Utility 

Explanation: OpenVMS RMS detected an error while connecting to the old 
format proxy database. 

User Action: Take action based on the accompanying message. 

ONFCREERR, unable to create old format proxy database (NETPROXY.DAT) 
Facility: UAF, Authorize Utility 

Explanation: OpenVMS RMS encountered an error while attempting to 
create the old format proxy database. 

User Action: Take action based on the accompanying message. 
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ONFINVREC, invalid old format proxy database record format 
(NETPROXY.DAT) 

Facility: UAF, Authorize Utility 

Explanation: A record in the old format proxy database has an invalid 
record format. This error can occur when the old proxy database is damaged. 

User Action: Restore the old format proxy database from a backup copy and 
reenter the command. 

ONFMAXEX, exceeded maximum local proxy count in old format proxy database 
(NETPROXY.DAT) 

Facility: UAF, Authorize Utility 

Explanation: An attempt was made to add more than 16 local users to a 
specific proxy record for a remote node and user. 

User Action: Remove a sufficient number of local users from the proxy 
record and reenter the command. 

ONFMODERR, error modifying entry in old format proxy database 
(NETPROXY.DAT) 

Facility: UAF, Authorize Utility 

Explanation: OpenVMS RMS encountered an error while attempting to 
write a record in the old format proxy database. 

User Action: Take action based on the accompanying message. 

ONFNPDAEX, old format proxy database already exists (NETPROXY.DAT) 
Facility: UAF, Authorize Utility 

Explanation: The /PROXY qualifier was specified on the CREATE command 
and the old format proxy database already exists. 

User Action: None. 

ONFNPDDNE, old format proxy database does not exist (NETPROXY.DAT) 
Facility: UAF, Authorize Utility 

Explanation: The /OLD qualifier was specified with /PROXY on a SHOW 
or LIST command to display information contained in the old format proxy 
database, but such a database does not exist. 

User Action: Omit the /OLD qualifier from the command to display 
information from the proxy database. 

ONFOPNERR, unable to open old format proxy database (NETPROXY.DAT) 
Facility: UAF, Authorize Utility 

Explanation: An error occurred while trying to open the old format proxy 
database. 

User Action: Take action based on the accompanying message. 

ONFREMERR, error removing entry from old format proxy database 
(NETPROXY.DAT) 

Facility: UAF, Authorize Utility 

Explanation: OpenVMS RMS encountered an error while attempting to 
delete a record from the old format proxy database. 

User Action: Take action based on the accompanying message. 
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OPREQRD, specify the operation (such as INSTALL) in the PRODUCT 
command line 

Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: A required parameter is missing from the command. 

User Action: Specify the operation (for example, INSTALL, REMOVE, 
RECONFIGURE, SHOW) in the command line. 

OPTINVKIT, OPTION statement invalid in distribution type PATCH, PARTIAL, 
MANDATORY UPDATE, or TRANSITION 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: An option statement is included in a product description file 
(PDF) that is not for one of the following kit types: full, operating system, or 
platform. The kit types named in the message do not allow you to present 
configuration choices to the user. 

User Action: Either remove the option statement or modify the product 
statement to be the correct type. 

OUTRANGE, number out of range 

Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: The response is not a number within the displayed range. 
User Action: Enter an integer from the range of listed products. 

PARDES, the ' object-type' ' object-name' is part of an option that was not 
selected - ' object-type' update skipped 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: The named managed object will not execute in this operation. 
User Action: None. 

PART_SERIAL, transaction aborted because a resource manager serialization 
check failed 

Facility: DDTM, DECdtm Services 

Explanation: A resource manager serialization check failed. 

User Action: Retry the transaction. 

PART_TIMEOUT, transaction aborted because a resource manager timeout 
expired 

Facility: DDTM, DECdtm Services 

Explanation: A resource manager exceeded its execution timeout. 

User Action: Retry the transaction. 

PARUDF, the 'object-type' 'object-name' has not been provided by a previous 
Install or Register operation - 'object-type' update skipped 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: You attempted to update a managed object that is not known 
to the POLYCENTER Software Installation utility, for example, an object 
provided by a previous install or register operation. 

User Action: Check the product database and your command to verify that 
you are trying to update a known managed object. 
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PDFEND, unmatched end 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: You specified a group statement in the product description file 
(PDF) without a corresponding end group statement. 

User Action: Check the group statements in the PDF for missing or 
extraneous end statements. 

PDFEOF, unexpected end of file 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: You specified a group statement in the product description file 
(PDF) without a corresponding end group statement. 

User Action: Check the group statements in the PDF and add the missing 
end statement. 

PDFLIN, ' line-number' ' text' 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: An error was detected in the specified line and text of the 
product description file (PDF). 

User Action: Fix the text on the specified line in the PDF. 

PDFMTX, duplicate or mutually exclusive option specified 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: You either specified an option twice or specified incompatible 
options with a product description language (PDL) statement. 

User Action: Review your option specifications. 

PDFSTR, PRODUCT statement must be the only statement at the outermost 
level 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: There are statements outside the product and end product 
statements in the product description file (PDF). 

User Action: Make sure all statements in the PDF come after the product 
statement and before the end product statement. 

PKGCNT, packaging more than one product may result in an unexpected kit 
Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: This informational message warns that kit problems can occur 
if more than one product's kit is packaged in one PACKAGE operation. 

User Action: Use a separate PACKAGE command to package each kit. 

PKGREQD, source, destination, and material specification required for this 
operation 

Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: The PACKAGE command is missing one or more required 
qualifiers. 

User Action: Specify all of the following qualifiers in the PACKAGE 
command: 
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/SOURCE Specifies an explicit source search path in which to find 

product description and text files. 

/MATERIAL Specifies a source search path for the files associated with the 

product. 

/DESTINATION Specifies an explicit destination directory specification in 

which to create the packaged kit. 

PRCERR, error communicating with subprocess; status returned from DCL 
follows 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: An error occurred while communicating with the Digital 
Command Language (DCL) shell subprocess. 

User Action: Take action based on any accompanying error messages and 
retry the operation. 

PRDALRREM, product has been removed 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: You attempted to remove a product that has already been 
removed. 

User Action: Verify the name of the product you want to remove. 

PRDSTAABS, operation invalid on product 'product-name' that is absent 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: You attempted to perform an operation on a product that 
is not on the system or is not accessible to the POLYCENTER Software 
Installation utility. 

User Action: Verify that you are attempting the operation on the correct 
product. If necessary, install the correct product and make it available on the 
system. 

PROXYCONVERT, old-format proxy database needs to be converted 
Facility: SYSTEM, System Services 

Explanation: The security server startup command procedure detected an 
existing NETPROXY.DAT file with no corresponding NET$PROXY.DAT file. 
This error occurs when the old-format NETPROXY.DAT database file has not 
yet been converted to a new NET$PROXY.DAT database following a system 
upgrade. 

User Action: Run the conversion utility (CONVERT_PROXY) to convert 
NETPROXY.DAT. (See the installation documentation for details.) 

PROXYMISSING, old-format proxy database file is missing 
Facility: SYSTEM, System Services 

Explanation: The security server startup command procedure detected a 
new format proxy database (NET$PROXY.DAT) with no corresponding old 
format proxy database (NETPROXY.DAT). Probably the CONVERT_PROXY 
utility was run to create the new database, and then the old format database 
was deleted. The old database is required on the system by DECnet Phase TV 
and many layered products. 

User Action: Restore NETPROXY.DAT from backup files. 


A—17 



New OpenVMS System Messages 


PTFDUPMOD, duplicate module name in product text file 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: More than one text module has the same name in the product 
text file (PTF). 

User Action: Remove the duplicate module or change the name of the 
module in the product text file (PTF). 

PTFDUPPRM, duplicate parameter line for this module in product text file 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: There is more than one parameter line (starting with an equal 
sign) of the same type for a text module in the product text file (PTF). 

User Action: Change or remove any duplicate parameter lines in the text 
module. 

PTFINVMOD, invalid module header syntax in product text file 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: A text module header in the product text file (PTF) contains a 
syntax error. 

User Action: Fix the syntax of the text module header and the module name 
in the PTF. 

PTFINVPRM, invalid parameter line syntax in product text file 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: An unrecognized parameter line was found in a text module in 
the product text file (PTF). 

User Action: Correct the syntax or remove the unrecognized parameter line. 

PTFMISMAT, =PRODUCT directive field does not match PRODUCT statement 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: The product information in the =PRODUCT directive of the 
product text file (PTF) does not match the product information in the product 
statement of the product description file (PDF). 

User Action: Make sure the product statement and the =PRODUCT 
directive contain the same information. 

PTFMISMOD, missing product text file module for 'name' 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: The product description file (PDF) specifies a text module that 
does not exist in the product text file (PTF). 

User Action: Verify that the PTF contains the correct text modules and that 
their names match those specified in the PDF. 

PTFMISPRD, required =PRODUCT directive missing in product text file 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: The utility cannot find the =PRODUCT directive in the 
product text file (PTF). 

User Action: Verify that the first line of the PTF is an =PRODUCT directive. 
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PTFMISPRM, missing required parameter line for previous module in product 
text file 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: A text module in the product text file (PTF) is missing a 
required parameter line (starting with an equal sign). 

User Action: Review the matching statement types in the product 
description file (PDF) to determine what parameter lines are required in the 
text module. Add any missing parameter lines. 

PTFNOHDR, missing module header in product text file 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: A text module in the product text file (PTF) is missing a 
module header. 

User Action: Add a text module header to the module in the PTF. 

PTFPRD1ST, =PRODUCT directive must be first line in product text file 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: The first line of the product text file (PTF) does not contain an 
=PRODUCT directive. 

User Action: Correct the first line of the PTF. 

PTFUNDMOD, undefined module name in product text file 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: A text module header in the product text file (PTF) has a 
module name that is not defined in the corresponding product description file 
(PDF). 

User Action: Either remove the text module from the PTF or add the 
statement that corresponds to this text module to the PDF 

PTFUNDPRM, parameter line type not defined for this module in product text 
file 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: A text module in the product text file (PTF) contains a 
parameter line (starting with an equal sign) that is not allowed for this 
module type. 

User Action: Correct or remove the undefined parameter line. 

REFUNA, product 'product-name' is required by 'product-name' 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: A product required by another product executing in this 
operation is unavailable. 

User Action: Install the required product or make it available. 

REFUNAPRC, product 'product-name' is required by 'product-name' on node 
' node-name' 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: A product required by another product executing in this 
operation is unavailable on a specific processor. 

User Action: Install the required product or make it available on the 
processor. 
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RELOFEXOUT, deferred relocation/fixup is outside image boundaries at location 
' location' 

Facility: LINK, Linker Utility 

Explanation: An attempt was made to write relocation or fixup information 
into the image outside of the image section boundaries. This condition 
indicates a compiler or linker fault. 

User Action: Submit a Software Performance Report (SPR). 

REMRUNOS, cannot remove the running operating system 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: You attempted to remove the operating system without first 
shutting it down. 

User Action: Shut down the operating system and retry the operation. 
Requires 'number' disk blocks. 

Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: This product or configuration choice requires the specified 
number of disk blocks. 

User Action: None, unless disk space might be overrun by this operation. In 
this case, stop the operation and create enough disk space on the destination 
device. 

Requires from 'number' to 'number' disk blocks depending upon configuration. 
Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: This product or configuration choice requires the specified 
number of disk blocks. The lower number is required if no configuration 
choices are selected. The higher number is required if all configuration 
choices are selected. 

User Action: None, unless disk space might be overrun by this operation. In 
this case, stop the operation and create enough disk space on the destination 
device. 

RESGEN, the 'object-type' 'object-name' provided by 'object-type' will remain 
installed; replacement material unavailable 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: A managed object that has no replacement material in the 
newer version (or whose replacement material is unavailable) will remain on 
the system. 

User Action: None. 

RMTMNTFAIL, ' device' failed to mount on node ' node' 

Facility: MOUNT, Mount Utility 

Explanation: An attempt to mount a device clusterwide failed to mount the 
device on a remote node. 

User Action: Take action based on the accompanying message. 
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RMVINVKIT, REMOVE statement invalid in distribution type TRANSITION 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: A transition product description file (PDF) contains a remove 
statement. 

User Action: Delete the remove statement or change the distribution type to 
something other than transition . 

SERIALIZATION, transaction aborted because a serialization check failed 
Facility: DDTM, DECdtm Services 
Explanation: A serialization check failed. 

User Action: Retry the transaction. 

SFTCIRC, referenced product 'product-name' causes circular dependency 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: Two products refer to each other, causing a dependency that 
the utility cannot resolve. 

User Action: Examine the products’ product description files (PDFs) to 
ensure that they contain no circular software statement dependencies; for 
example, product A requires product B, which requires product A. 

SFTCNFINS, installed product 'product-name' does not satisfy 
Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: The specified installed product does not satisfy the constraints 
of a software statement in a selected product. 

User Action: Terminate the operation and check the product database to be 
sure you are upgrading the correct product. 

SFTCNFLCT, the following products also have requirements for ' product-name': 
Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: Certain selected or installed products have constraints on the 
named product. 

User Action: None. 

SFTCNFSEL, selected product ' product-name' does not satisfy 
Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: The named, selected product does not satisfy the constraints 
of a software statement in another selected product. 

User Action: Terminate the operation and deselect one of the conflicting 
products. 

SFTREFERR, referenced product 'product-name' not found for product 
' product-name' 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: A product that is referenced by a selected product cannot be 
located. 

User Action: Either deselect the product or locate the product kit (possibly 
in another source area) and try again. 
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SFTREFREM, referenced product ' product-name' removed from database 
Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: The named, referenced product will be removed from the 
product database or, in some operations, the POLYCENTER Software 
Installation utility will ask whether to remove it. 

User Action: If given a choice, choose Yes to remove the product or No to 
keep it. 

SHELFERROR, access to shelved file failed 
Facility: SYSTEM, System Services 

Explanation: An attempt to access a file failed. The file was shelved and 
the shelving facility could not unshelve it. 

User Action: Take action based on the accompanying message. 

SHELVED, ' file-name' data not copied, file is shelved 
Facility: BACKUP, Backup Utility 

Explanation: An image mode save operation was performed on a file that 
is currently shelved. Therefore, only the file header was saved; no data was 
transferred to the save set. 

User Action: None required. However, if you want to create an image 
backup that includes the contents of the specified file, use the UNSHELVE 
command to bring the file back on line before performing the image mode 
backup. 

SHELVED, file is shelved 

Facility: SYSTEM, System Services 

Explanation: Your process tried to access a shelved file, and automatic 
unshelving is turned off. 

User Action: Do one of the following: 

• Use the DCL command SET PROCESS/AUTOJJNSHELVE to turn 
automatic unshelving on. 

• Use the DCL command UNSHELVE to unshelve the shelved file. 

SHLVSTATE, 'file-name' has changed shelved state 
Facility: BACKUP, Backup Utility 

Explanation: During a compare or verify operation, the Backup utility 
detected that the data contents of the specified file have been shelved and the 
file contents are unavailable for verification. This condition can occur when 
shelving activity on the volume causes the file state to change from online to 
shelved. 

User Action: Specify the /AUTOUNSHELVE qualifier on the SET PROCESS 
command to change the process shelving default to autounshelve, or disable 
shelving activity during the backup operation. 

TERMIMM, 'number' licenses will terminate in 'number' days 
Facility: SHOW, SHOW Command 

Explanation: Termination is imminent for one or more of the listed licenses. 

User Action: If you plan to continue using these products, you must obtain 
a new license before the specified termination date to maintain product 
availability. 
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UNDEFER, that item is no longer deferred. Please set the value 
Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: No value is set for this configuration choice. 

User Action: Supply a value for the configuration choice if the choices are to 
be written to a configuration file. 

UNRDEP, failed to resolve execution order dependency for 'object-type' 'object- 
name' 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: A required software dependency cannot be resolved. 

User Action: Check the product database and available kits for more 
information. 

UNRDEPNNM, failed to resolve execution order dependency for ' object-type' 
(unnamed) 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: A required software dependency cannot be resolved. 

User Action: Check the product database and available kits for more 
information. 

UNSHELVED, file is not shelved 

Facility: SYSTEM, System Services 

Explanation: You tried to unshelve a file that is not shelved. 

User Action: None. 

UNSHELVERR, error unshelving file 'file-name' 

Facility: PRINT, PRINT Command 
Facility: SUBMIT, SUBMIT Command 

Explanation: An RMS error or a memory management error occurred while 
unshelving the file. 

User Action: Take action based on the accompanying messages. 

UNSUPCOMBOP, 'product-name' uses an unsupported combination of options 
and license type 

Facility: LICENSE, License Management Utility 

Explanation: You attempted to load a license with attributes that LMF does 
not support. Specifically, the combination of key options and license type is 
not supported. 

User Action: Notify the issuer of the Product Authorization Key (PAK) and 
obtain a PAK that LMF can use. 

UNVSTATUS, translation of symbol $STATUS is unavailable 
Facility: MSGHLP, Help Message utility 

Explanation: Help Message cannot translate the CLI symbol $STATUS to 
determine the result of the last executed command. Either the $STATUS 
symbol has been deleted, no command has been executed, or the first and 
only command was aborted by Ctrl/Y. 

User Action: Reissue the HELP/MESSAGE command and specify a search 
string or the /STATUS or /FACILITY qualifier. The default HELP/MESSAGE 
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command will work properly when $STATUS is available and a command has 
been executed. 

UPGRADERR, existing version of product that ' product-name' upgrades is 
incorrect 

Facility: PCSI, POLYCENTER Software Installation Utility 

Explanation: The named product has an upgrade statement that directs the 
POLYCENTER Software Installation utility to upgrade an existing version of 
the same product. The existing version fails to meet the version constraints 
of the new product. An upgrade of the existing product is not possible with 
this product kit. 

User Action: Verify whether the upgrade was already completed. 

VERERR, verification error for ' file-name' 

Facility: PCSI, POLYCENTER Software Installation Utility 
Explanation: A verification error occurred on the named file. The resulting 
output file is not equal to the input file. 

User Action: Retry the operation. 

VERSELCT, this selection unselected a previous version 

Facility: PCSIUI, POLYCENTER Software Installation Utility 

Explanation: The current product version selection has superseded a 
previous product version selection. Only one version of a product can be 
selected for this operation. 

User Action: Verify that the correct product version is selected. 

VOLSETALRMNT, another volume set of same label already mounted 
Facility: MOUNT, Mount Utility 

Explanation: Either a volume set with the specified name is already 
mounted in the cluster, or the devices were mounted into the volume set in a 
different order on another node. 

User Action: Rename the volume set to a unique name or, if the same 
volume set is already mounted on another node, ensure that devices are 
mounted into the volume set in the same order. 

WRGARCH, ' product-name' license is not valid on this architecture 
Facility: LICENSE, License Management Utility 

Explanation: You attempted to load a license that cannot be used on the 
current architecture. For example, you attempted to load a license designated 
for use only on VAX systems onto an AXP system. 

User Action: Obtain the correct Product Authorization Key (PAK) for your 
system. 

WRITE, that item will be written to configuration file. Please set the default 
value 

Facility: PCSIUI, POLYCENTER Software Installation Utility 
Explanation: No value is assigned for this configuration choice. 

User Action: Supply a value for the configuration choice if this choice is to 
be written to a configuration file. If no file is being written, you can press 
Ctrl/D to defer the choice. 
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OpenVMS RTL Library, 4-12 
DECnet for OpenVMS VAX 
node names, 3-3 
DECwindows Motif display server 
See Display server 
DECwindows Motif new features 

DECnet/OSI full names support, 2-8 
Device support 

for SCSI-1 and SCSI-2, 6-3 
Display server, 5—1 
customizing, 5-1 
font name support, 5-5 
keymap name support, 5-4 
parameters for customizing, 5-1 
Documentation comments, sending to Digital, iii 
Driver design 

for SCSI-2, 6-1 

E_ 

ERRFMT 

See Error formatter 

ERRFMT$SEND_TO logical name, 3-1 
ERRFMT$_SEND_MAIL logical name, 3-1 
Error formatter (ERRFMT), 3-1 
Error messages 

new messages, A-l 
Error recovery 

SCSI devices, 6—4 

F_ 

FDL$CREATE 

optional argument dlft_fdl_spc, 4—8 
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Feedback on documentation, sending to Digital, iii 
$FILESCAN system service 
enhancements to, 4—14 
File shelving 

general information, 2—9 
File system 

performance improvements, 3-1 
Fonts 

in DECwindows display server, 5-5 
Lucida Bright, 5-5 
Lucida Sans, 5—5 
Lucida Typewriter, 5—5 
VT330, 5-5 
Full names 

Debugger support, 4—7 
DECnet/OSI 

definition, 3—3 
syntax, 3-3 

OpenVMS RTL Library, 4-12 

H_ 

Head of port queue 
SCSI-2 devices, 6-4 
Help Message utility (MSGHLP) 

accessing $STATUS values for uninstalled 
messages, 2-9 
message section files, 2-10 
order searched, 2-10 
new features, 2-9 

/SECTION_FILE qualifier usage, 2-10 
HSM 

See POLYCENTER HSM for OpenVMS, 2-9 

I_ 

I/O flow 

using SCSI queues, 6-6 
Incoming port queue 
SCSI devices, 6-1 
In-device port queue 
SCSI devices, 6-1 

IO$M_MOVEFILE subfunction, 4—10 
IO$_CREATE function code, 4—9 
IO$_MODIFY function code, 4—9 

K_ 

Keymap name support, 5-4 

L_ 

LAN device 

DEFAA, 4-10 
DEFEA, 4-10 
DEFQA, 4-10 


LAN driver 

FADRIVER, 4-10 
FQDRIVER, 4-10 
FRDRIVER, 4-10 
LAT symbionts 
customizing, 4-1 
LOGINOUT 

callout routines, 4-5 

Log Manager Control Program (LMCP) utility 
CLOSE LOG command, 3-1 
Lucida font support, 5-5 

M_ 

Macros 

SCSI port interface (SPI$), 6—21 
Messages 

new system messages, A-l 
Movefile subfunction, 4-10 

N_ 

Namespace 

in DECnet/OSI full name, 3-3 
Nearline storage 
definition, 2-9 
Node names 

DECnet/OSI full names, 3-3 
DECnet for OpenVMS VAX, 3-3 
Non-queued I/O 

SCSI devices, 6-4 

O_ 

Offline storage 
definition, 2—9 
Online storage 
definition, 2-9 
Ordered queuing 

SCSI-2 devices, 6-4 

P_ 

/PAGE=SAVE qualifier navigation keys, 2-8 
Parameters 

See System parameters 
PATHWORKS 

new system parameters for XQP+, 3-2 
PCSI, 3-4 

POLYCENTER HSM for OpenVMS, 2-9 
POLYCENTER Software Installation utility, 3-4 
benefits of using, 3-4 
Port-queue architecture, 6-1 
Port queues 
I/O flow, 6—6 

Program access to conversion statistics array, 4—3 
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Program access to Convert options array, 4-2 
Program access to Convert/Reclaim statistics 
array, 4-4 

Q_ 

QErr bit 

queue recovery, 6—5 
Queue I/O requests 
using busy bit, 6-3 
Queues 

releasing, 6-24 
UCB busy, 6-3 
Queuing I/O 

SCSI support, 6—1 
Queuing system features 

See Batch and print queuing system features 

R_ 

RAB$B_KSZ 

used with performance caching optimization, 
4-12 

RAB$M_EQNXT option, 4-11 

used with reverse-search (RAB$M_REV) option, 
4-11 

RAB$M_KGT option 

used with reverse-search (RAB$M_REV) option, 
4-11 

RAB$M_NXT option, 4-11 
RAB$M_REV reverse-search option, 4—11 
Resource wait 

SCSI-2 support, 6-3 
Reverse-search key option 

design characteristics, 4-11 
performance, 4-12 

performance caching optimization, 4-12 
used with duplicate keys, 4-11 
use restriction, 4—11 
RMS 

reverse-search option, 4—11 
shelving support, 4-12 
Run-time library 

full names support, 4-12 

s_ 

SCDRP data structure, 6-7 
SCDT$V_CMDQ characteristic bit 
SCSI, 6-5 

SCDT$V_SCSI_2 characteristic bit, 6-5 

SCDT data structure, 6-13 

SCSI-1 and SCSI-2 mixed device support, 6—3 

SCSI-2 

data structures, 6—7 
device support, 6-1 to 6-7 
drivers 

design, 6-1 


SCSI-2 (cont’d) 

INQUIRY data, 6-5 
macros, 6-21 
port interface (SPI), 6-4 
SCSI command 

sending to SCSI-2 device, 6-22 
SCSI errors, 6—5 

recovery sequence, 6—7 
SCSI queues 
I/O flow, 6—6 
recovering, 6—5 
Security system services, 4-14 
Sequential access, 4-11 
Server 

See Display server 
SET MESSAGE command 

used to access uninstalled messages, 2—10 
Shadowing 

system parameters for, 3-5 
Shelving 

DCL commands, 2-3, 2-4, 2-5, 2-6 
general information, 2-9 
RMS support, 4-12 
SHOW LICENSE command, 3-2 
SPDT data structure, 6-17 
SPI 

See SCSI-2 port interface 
SPI$CONNECT macro 

for SCSI-2 support, 6-21 
SPI$GET_CONNECTION_CHAR routine 
with SCSI-2 devices, 6-5 
SPI$GET_CONNECT_CHAR macro 
for SCSI-2 support, 6-21 
SPI$QUEUE_COMMAND macro, 6-5, 6-22 
SPI$RELEASE_QUEUE macro, 6-5, 6-24 
SPI$SET_CONNECTION_CHAR routine 
with SCSI-2 devices, 6-5 
SPI$SET_CONNECT_CHAR macro 
for SCSI-2 support, 6-21 
STARTIO routine 
UCB busy bit, 6—3 
$STATUS values 

accessing for uninstalled messages, 2-9 
SYS$ADD_PROXY system service, 4-14 
SYS$DELETE_INTRUSION system service, 4-15 
SYS$DELETE_PROXY system service, 4-14 
SYS$DISPLAY_PROXY system service, 4-15 
SYS$SCAN_INTRUSION system service, 4-15 
SYS$SETSHLV system service, 4-15 
SYS$SHOW_INTRUSION system service, 4-15 
SYS$VERIFY_PROXY system service, 4-15 
SYSGEN parameters 

See System parameters 
System messages 

accessing $STATUS values for uninstalled 
messages, 2-9 
new messages, A—1 
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System parameters 
for shadowing, 3—5 
XQPCTL2, 3-2 
XQPCTLD1, 3-2 
System services, 4—13 
$ADD_PROXY, 4-14 
$DELETE_INTRUSION, 4-15 
$DELETE_PROXY, 4-14 
$DISPLAY_PROXY, 4-15 
$FILESCAN, 4-14 
$SCAN_INTRUSION, 4-15 
$SETSHLV, 4-15 
$SHOW_INTRUSION, 4-15 
$VERIFY_PROXY, 4-15 


T 


U_ 

UCB$M_BSY bit 

in SCSI class driver, 6-3 
UCB busy queue, 6-3 
Unordered queuing 
SCSI-2 devices, 6-4 
/USAGE qualifier 

with the SHOW LICENSE command, 3-2 


V_ 

Volume shadowing 

on Open VMS AXP systems, 3-5 
VT330 font support, 5-5 


Tagged command queuing X 

device support, 6—1 - 

I/O requests, 6-1 XABITM data structure 

XAB$_UCHAR__NOSHELVABLE, 4-12 
XAB$_UCHAR_SHELVED, 4-12 
XQP+, 3-2 

XQPCTL2 system parameter, 3-2 
XQPCTLD1 system parameter, 3-2 
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NOTES 
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NOTES 


How to Order Additional Documentation 


Technical Support 

If you need help deciding which documentation best meets your needs, call 800-DIGITAL (800-344-4825) 
and press 2 for technical assistance. 


Electronic Orders 

If you wish to place an order through your account at the Electronic Store, dial 800-234-1998, using a 
modem set to 2400- or 9600-baud. You must be using a VT terminal or terminal emulator set at 8 bits, no 
parity. If you need assistance using the Electronic Store, call 800-DIGITAL (800-344-4825) and ask for an 
Electronic Store specialist. 


Telephone and Direct Mail Orders 


From 


Call 


Write 


U.S.A. 


Puerto Rico 


Canada 


International 


Internal Orders 1 
(for software 
documentation) 


Internal Orders 
(for hardware 
documentation) 


DECdirect 

Phone: 800-DIGITAL 
(800-344-4825) 

Fax: (603) 884-5597 

Phone: (809) 781-0505 
Fax: (809) 749-8377 


Phone: 800-267-6215 
Fax: (613) 592-1946 


DTN: 264-3030 
(603) 884-3030 
Fax: (603) 884-3960 


DTN: 264-3030 
(603) 884-3030 
Fax: (603) 884-3960 


Digital Equipment Corporation 
P.O. Box CS2008 
Nashua, NH 03061 


Digital Equipment Caribbean, Inc. 

3 Digital Plaza, 1st Street 

Suite 200 

Metro Office Park 

San Juan, Puerto Rico 00920 

Digital Equipment of Canada Ltd. 
100 Herzberg Road 
Kanata, Ontario, Canada K2K 2A6 
Attn: DECdirect Sales 

Local Digital subsidiary or 
approved distributor 

U.S. Software Supply Business 
Digital Equipment Corporation 
10 Cotton Road 
Nashua, NH 03063-1260 

U.S. Software Supply Business 
Digital Equipment Corporation 
10 Cotton Road 
Nashua, NH 03063-1260 


1 Call to request an Internal Software Order Form (EN-01740-07). 
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OpenVMS VAX Version 6.1 
New Features Manual 

AA-PV70B-TE 


Your comments and suggestions help us improve the quality of our publications. 
Thank you for your assistance. 


I rate this manual’s: 

Accuracy (product works as manual says) 
Completeness (enough information) 
Clarity (easy to understand) 

Organization (structure of subject matter) 
Figures (useful) 

Examples (useful) 

Index (ability to find topic) 

Page layout (easy to find information) 
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What I like best about this manual is 
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I found the following errors in this manual: 
Page Description 


Additional comments or suggestions to improve this manual: 


For software manuals, please indicate which version of the software you are using: 


Name/Title _ 

Company _ 

Mailing Address 


Dept. _ 

_ Date 


Phone 
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